Skip to main content
从 2022 年 6 月版的 Microsoft 游戏开发工具包 (GDK) 开始,使用 Visual Studio 附带的本机代码调试器来调试 PC 游戏项目。若要在本地 PC 上调试,请在 Visual Studio 工具栏的调试器下拉列表中选择 本地 Windows 调试器,如下图所示。 若要在远程 PC 上调试,请选择 远程 Windows 调试器 并按照 在远程 PC 上调试游戏 中描述的步骤操作。
用于使用 2022 年 6 月之前版本 Microsoft 游戏开发工具包 (GDK) 的项目的调试器名为 Local Machine。2022 年 6 月之前版本的 Microsoft 游戏开发工具包 (GDK) 不支持远程调试。
将项目升级到 2022 年 6 月版 Microsoft 游戏开发工具包 (GDK) 时,可能会出现调试器属性被设置为 Unsupported debug option 的情况,如下图所示。发生这种情况时,必须使用调试工具栏、项目属性页或将 DebuggerFlavor msbuild 属性设置为 WindowsLocalDebugger 将调试器属性重置为 本地 Windows 调试器(完全删除 DebuggerFlavor 属性也会导致使用 本地 Windows 调试器)。 从 2022 年 6 月版的 Microsoft 游戏开发工具包 (GDK) 开始,PC 项目不再需要部署步骤。Visual Studio 的 配置管理器 对话框中的 部署 复选框已禁用。 零售版启动游戏时,会使用一个中间启动程序进程。此引导程序进程会在游戏渲染之前显示启动画面、检查游戏更新、预同步云存档、预登录用户等。这些行为在松散文件调试场景中不会被执行。使用 打包构建 来测试或调试游戏在零售版中启动时的情况。

​
调试打包构建

在调试打包构建之前,必须使用 wdapp install 安装包。安装后,可以使用 Visual Studio 中的 Debug Installed App Package 功能调试游戏。使用 调试 菜单打开调试对话框,如下图所示。 若要调试你的游戏,请在对话框中搜索它,将 Debug this code type 设置为 Native Only,然后单击 开始 按钮。 若要按零售环境中启动的方式调试你的游戏,请在 wdapp install 命令行中添加 /bootstrapper 标志。以这种方式安装的游戏将由引导程序进程启动。此场景中的调试需要 Visual Studio 中的 子进程调试 扩展。使用 管理扩展 对话框安装该扩展。 安装后,使用 调试 菜单查看 子进程调试 设置。 在设置页面上单击 启用子进程调试 复选框。 启用子进程调试后,Debug Installed App Package 对话框现在会将调试器附加到游戏而不是引导程序进程。

​
在远程 PC 上调试游戏

在远程 PC 上调试游戏需要 Visual Studio 远程工具。按照 在 Visual Studio 中远程调试 C++ 项目 中描述的方法安装工具并配置远程调试器。 在项目属性页上的 要启动的调试器 下拉列表中选择 远程 Windows 调试器。输入游戏可执行文件的名称、所需的工作目录等。默认情况下,Visual Studio 将部署游戏的可执行文件和二进制依赖项。若要调试远程 Microsoft 游戏开发工具包 (GDK) 游戏,还需要部署其他文件,包括 MicrosoftGame.config 文件和徽标文件。使用 远程 Windows 调试器 属性页上的 要部署的其他文件 属性指定要部署的其他文件,如下图所示。

​
另请参阅

Visual Studio
最后修改于 2026年8月13日

相关主题

Visual StudioVisual Studio(目录)使用 Visual Studio 调试 XBOX 项目在 Visual Studio 中远程调试 Windows 设备上的 PC 项目Visual Studio 2022 GDK 支持说明