> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visual Studio 2026 GDK 支持说明

> Visual Studio 2026 Microsoft Game Development Kit (GDK) 支持说明

本文介绍 GDK 对 Visual Studio 2026 的支持情况。[Visual Studio 2026](https://visualstudio.microsoft.com/) 支持 Microsoft Game Development Kit (GDK) 开发。

## 安装 Visual Studio 2026

GDK 支持使用 Visual Studio 2026 的 **Professional** 版或 **Enterprise** 版进行开发。不支持 Community 版。

<Info>基于 ARM 的设备不支持 GDK 的 Visual Studio 扩展 (VSIX) 组件。若要使用 GDK 的 Visual Studio 项目模板、属性页和调试扩展，请在基于 x64 的开发 PC 上安装 GDK。</Info>

安装 Visual Studio 2026 时，请在安装过程中选择 **使用 C++ 的游戏开发** 工作负载，如下面的截图所示。

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2026_workloads_game_development.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=490c6dc55a6864b274ec5d2ae2dd61c1" alt="在 Visual Studio 2026 中安装“使用 C++ 的游戏开发”工作负载" width="1920" height="1080" data-path="images/gdk/tools/vs2026_workloads_game_development.png" />

除了游戏开发所需的核心 C++ 工具之外，请确保安装 **Windows 10 SDK (22000)** 组件，以提供使用 GDK 构建游戏所需的 Windows SDK。你也可以使用 \*Windows SDK for Windows 11, Version 22H2 (10.0.22621) 或 *Windows SDK for Windows 11, Version 24H2 (10.0.26100)*，但它们并非必需。

虽然并非必需，但安装 **使用 C++ 的桌面开发** 工作负载可以提供更多有用的工具和示例。例如，如果你使用 Clang/LLVM 工具集进行构建，则需要 **使用 C++ 的桌面开发**。

## 安装可选工具集

**使用 C++ 的游戏开发** 工作负载会安装 Visual Studio 2026 版本的 MSVC 生成工具（版本 **v145**）。除 **v145** 工具集外，GDK 还支持使用以下工具集进行构建：

* v143（Visual Studio 2019 工具集）
* v142（Visual Studio 2019 工具集）
* 面向 Windows 的 C++ Clang 工具

这种灵活性使你能够在不更新工具集的情况下升级到 Visual Studio 2026 IDE。

你可以在 **使用 C++ 的桌面开发** 工作负载下找到可选工具集，或者在 Visual Studio 安装对话框中搜索 **单个组件** 找到它们。

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2026_optional_toolsets.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=8b3b23925fc790c34859f7f31f5646c0" alt="在安装 Visual Studio 2026 时选择可选工具集" width="1920" height="1080" data-path="images/gdk/tools/vs2026_optional_toolsets.png" />

## 为项目选择工具集

通过项目属性页中的 **平台工具集** 属性来指定要用于项目的工具集。

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2026_specify_a_toolset.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=b14e8d129824118c1124bfadbd21eafa" alt="指定生成项目时要使用的工具集" width="1201" height="820" data-path="images/gdk/tools/vs2026_specify_a_toolset.png" />

也可以在项目文件中手动指定 **PlatformToolset** 属性，如以下属性组所示。

```xml theme={null}
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Gaming.Xbox.Scarlett.x64'" Label="Configuration">
  <ConfigurationType>Application</ConfigurationType>
  <PlatformToolset>v145</PlatformToolset>
  <UseDebugLibraries>true</UseDebugLibraries>
  <CharacterSet>Unicode</CharacterSet>
  <EmbedManifest>false</EmbedManifest>
  <GenerateManifest>false</GenerateManifest>
</PropertyGroup>
```

## Visual Studio 2026 服务模型

Visual Studio 2026 引入了新的服务模型，包含 Insiders 和稳定通道。有关更多信息，请参阅 [Visual Studio 产品生命周期与服务](https://learn.microsoft.com/visualstudio/productinfo/vs-servicing)。

## 报告 Bug

对于 **Visual C++ 编译器** 的 Bug，请尽量通过 Visual Studio 的 *报告问题...* 提交。请参阅 [Microsoft Docs](https://learn.microsoft.com/visualstudio/ide/how-to-report-a-problem-with-visual-studio) 以及[开发者社区](https://aka.ms/feedback/report?space=62) 网站。有关如何为编译器创建高质量 Bug 报告的详细信息，请参阅[此页面](https://aka.ms/compilerbug)。

<Note>如果重现问题需要私密信息，你可以在标记为 “Microsoft only” 的公开报告问题中添加评论。</Note>

对于 **clang/LLVM for Windows 编译器** 的 Bug 报告，请使用 [https://bugs.llvm.org/](https://bugs.llvm.org/)

对于 **Microsoft Standard C++ Library**（也称为 STL）的 Bug 报告，请使用 [https://github.com/microsoft/STL/issues](https://github.com/microsoft/STL/issues)

一如既往，如遇需要升级处理的紧急问题，可随时联系你的 *Microsoft 联系人*。

## 另请参阅

[Visual Studio](/tools/tools-console/visualstudio/visualstudio)

[面向 XBOX 开发的 Visual Studio 项目模板](/tools/tools-console/visualstudio/durango-visual-studio-templates)

[面向 XBOX 开发的 Visual Studio 属性](/tools/tools-console/visualstudio/durango-property-pages)

[使用 Visual Studio 调试 XBOX 项目](/tools/tools-console/visualstudio/debugging-with-visualstudio)


## Related topics

- [Visual Studio 2022 GDK 支持说明](/zh-CN/tools/tools-console/visualstudio/vs-2022-support-notes.md)
- [Visual Studio 2019 GDK 支持说明](/zh-CN/tools/tools-console/visualstudio/vs-2019-support-notes.md)
- [Visual Studio 2019 支持说明](/zh-CN/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
- [Visual Studio 2022 支持说明](/zh-CN/tools/tools-pc/visualstudio/gr-vs-2022-support-notes.md)
- [Visual Studio(目录)](/zh-CN/tools/tools-pc/visualstudio/gr-visualstudio-toc.md)