> ## 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 2022 GDK 支援注意事項

> Visual Studio 2022 Microsoft Game Development Kit (GDK) 支援注意事項

本文說明 GDK 對 Visual Studio 2022 的支援。Visual Studio 2022 [17.12 或 17.14 版](https://learn.microsoft.com/visualstudio/releases/2022/servicing-vs2022)支援 Microsoft Game Development Kit (GDK) 開發。依據 [Visual Studio 產品生命週期與服務](https://learn.microsoft.com/visualstudio/productinfo/vs-servicing)，為 17.12 與 17.14 版提供長期支援通道。

<Note>Visual Studio 2022 17.0 到 17.11 版已於 2026 年 1 月終止支援。</Note>

## 安裝 Visual Studio 2022

GDK 支援使用 Visual Studio 2022 的 **Professional** 版或 **Enterprise** 版進行開發。不支援 Community 版。

<Info>ARM 型裝置不支援 GDK Visual Studio 延伸模組 (VSIX) 元件。若要使用 GDK Visual Studio 專案範本、屬性頁與偵錯延伸模組，請在 x64 型開發電腦上安裝 GDK。</Info>

安裝 Visual Studio 2022 時，請在安裝期間選取 **使用 C++ 的遊戲開發** 工作負載，如下列螢幕擷取畫面所示。

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2022_workloads_game_development.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=323e575e103c803e945a7b6eee4e0d3d" alt="使用 Visual Studio 2022 安裝使用 C++ 的遊戲開發工作負載" width="1157" height="514" data-path="images/gdk/tools/vs2022_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 2022 版本的 MSVC 建置工具 (版本 **v143**)。除了 **v143** 工具組之外，GDK 也支援使用下列工具組進行建置：

* v142 (Visual Studio 2019 工具組)
* 適用於 Windows 的 C++ Clang 工具

這種彈性可讓您升級至 Visual Studio 2022 IDE，而不需要更新工具組。

您可以在 **使用 C++ 的桌面開發** 工作負載底下找到選用工具組，或在 Visual Studio 安裝對話方塊中搜尋 **個別元件**。

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2022_optional_toolsets.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=dabf5dc04ac037d980dc20784cf60caa" alt="安裝 Visual Studio 2022 時選取選用工具組" width="1160" height="518" data-path="images/gdk/tools/vs2022_optional_toolsets.png" />

## 為專案選取工具組

使用專案屬性頁中的 **平台工具組** 屬性指定專案要使用的工具組。

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2022_specify_a_toolset.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=1ea3eed598eb3d7937b59384b6f5a563" alt="指定建置專案時要使用的工具組" width="788" height="539" data-path="images/gdk/tools/vs2022_specify_a_toolset.png" />

您也可以在專案檔中手動指定 **PlatformToolset** 屬性，如下列屬性群組所示。

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

## 使用 Visual Studio 2022 偵錯 XBOX 專案

若要使用 Visual Studio 2022 進行偵錯，請使用 2022 年 3 月 (或更新版本) 的 GDK 建置您要偵錯的遊戲。存在此相依性的原因是，這些 GDK 版本中隨附的 Game OS 包含使用 Visual Studio 2022 進行偵錯所需的二進位檔。如果您嘗試對較舊的 Game OS 使用 Visual Studio 2022 進行偵錯，會看到下列錯誤訊息。

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs_2022_old_gamos_debug_error.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=1c2d4c8fd1be70615c84d85d0ce2f216" alt="嘗試對早於 2022 年 3 月 GDK 隨附版本的 Game OS 使用 Visual Studio 2022 偵錯工具" width="418" height="191" data-path="images/gdk/tools/vs_2022_old_gamos_debug_error.png" />

在 Visual Studio 2022 中使用 **偵錯** 功能表底下的 **附加** 對話方塊時，請在 **連線類型** 下拉式清單中選取 **XBOX Direct Connection**，並在 **連線目標** 文字方塊中輸入主機的 Host IP 位址。使用 [xbconnect](/zh-TW/tools/tools-console/commandlinetools/xbconnect) 命令列工具判斷 Host IP。

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs2022_attach_dialog.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=71f8447875f069e11920e2d3a8ae12c5" alt="使用 Visual Studio 2022 附加對話方塊" width="860" height="611" data-path="images/gdk/tools/vs2022_attach_dialog.png" />

<Note>這些值與使用 Visual Studio 2019 附加時所輸入的值不同。使用 Visual Studio 2019 時，連線類型為 **Remote no authentication**，IP 位址為主機的 System IP 位址。</Note>

## Visual Studio 2022 服務模型

Visual Studio 2022 包含新的服務模型，您可以用來選取服務基準，然後只取得該基準的更新。此新模型取代了先前 Visual Studio 版本的服務模型，先前的模型強烈建議使用最新可用版本。如需詳細資訊，請參閱 [Visual Studio 產品生命週期與服務](https://learn.microsoft.com/lifecycle/products/visual-studio-2022)。

## 回報錯誤

**Visual C++ 編譯器**的錯誤報告請 (盡可能) 透過 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)網站。請務必閱讀[此頁面](https://aka.ms/compilerbug)，以了解如何為編譯器建立良好錯誤報告的詳細資訊。

<Note>如果需要私人資訊才能重現問題，您可以在公開報告問題中新增標示為「僅限 Microsoft」的註解。</Note>

若要回報 **clang/LLVM for Windows 編譯器**的錯誤，請使用 [https://bugs.llvm.org/](https://bugs.llvm.org/)

若要回報 **Microsoft 標準 C++ 程式庫** (又稱 STL) 的錯誤，請使用 [https://github.com/microsoft/STL/issues](https://github.com/microsoft/STL/issues)

一如往常，對於需要提報的重大問題，歡迎與您的 *Microsoft 代表*聯絡。

## 已知問題

* Game OS 不支援 C++20 P0355R7 \<chrono> *Calendars And Time Zones* 中新增的 `std:chrono` 時區功能，因為 XVD 映像中不包含 `icu.dll`、`icuin.dll`、`icuuc.dll` 或相關聯的資料檔案。如果您使用這些函式，應用程式會在執行階段擲回 C++ 例外狀況。PR0355R7 中的行事曆功能則受支援。

## 另請參閱

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

[XBOX 開發的 Visual Studio 專案範本](/zh-TW/tools/tools-console/visualstudio/durango-visual-studio-templates)

[XBOX 開發的 Visual Studio 屬性](/zh-TW/tools/tools-console/visualstudio/durango-property-pages)

[使用 Visual Studio 偵錯 XBOX 專案](/zh-TW/tools/tools-console/visualstudio/debugging-with-visualstudio)


## Related topics

- [Visual Studio 2022 支援注意事項](/zh-TW/tools/tools-pc/visualstudio/gr-vs-2022-support-notes.md)
- [Visual Studio 2019 支援注意事項](/zh-TW/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
- [Visual Studio 2019 GDK 支援注意事項](/zh-TW/tools/tools-console/visualstudio/vs-2019-support-notes.md)
- [Visual Studio 2026 GDK 支援注意事項](/zh-TW/tools/tools-console/visualstudio/vs-2026-support-notes.md)
- [Visual Studio](/zh-TW/tools/tools-pc/visualstudio/index.md)