跳轉到主要內容
本主題說明 Microsoft Game Development Kit (GDK) 對 Visual Studio 2019 的支援。Visual Studio 2019 16.11 版支援 Microsoft Game Development Kit (GDK) 開發。
Visual Studio 2019 16.0 - 16.10 版已於 2022 年 10 月終止支援。

安裝 Visual Studio 2019

安裝 Visual Studio 2019 時,您必須在安裝期間選取 使用 C++ 的遊戲開發 工作負載,如下列螢幕擷取畫面所示。 使用 C++ 的遊戲開發工作負載對話方塊的螢幕擷取畫面 除了 Windows PC 遊戲開發所需的核心 C++ 工具之外,使用 C++ 的遊戲開發也包含使用 Microsoft Game Development Kit (GDK) 建置 Windows PC 遊戲所需的 Windows 10 SDK 版本。 雖然並非必要,但安裝使用 C++ 的桌面開發工作負載可提供您可能覺得有用的其他工具與範例。 視您的需求而定,您可以選擇安裝其他選用工作負載或元件。
  • 如果您正在建置使用 Unity 的遊戲,請安裝 使用 Unity 的遊戲開發 工作負載。
  • MVSC 建置工具的 v142 版本會隨使用 C++ 的遊戲開發工作負載一起安裝。如有需要,您可以搭配 Visual Studio 2017 (v141) 中隨附的 MSVC 工具使用 Visual Studio 2019 整合式開發環境 (IDE)。使用較新的 IDE 而不升級至新的工具組,可讓您利用新的 IDE 功能,而不必更新原始程式碼以搭配新的編譯器運作。
若要搭配 Visual Studio 2019 IDE 使用 Visual Studio 2017 工具組,請安裝 使用 C++ 的桌面開發 工作負載底下的 MSVC v141 - VS 2017 C++ x64/x86 build tools (v14.16) 元件,如下列螢幕擷取畫面所示。自 2024 年 10 月版本起,不再支援 Visual Studio 2017 工具組。

將現有的 Visual Studio 2017 專案移轉至 Visual Studio 2019

在大多數情況下,Visual Studio 隨附的升級精靈可以將您的專案移轉至 Visual Studio 2019,而不需要任何其他變更。當您在 Visual Studio 2019 中開啟 Visual Studio 2017 專案時,會看到下列 [檢閱方案動作] 對話方塊,提示您進行升級。若要升級專案,請選取 確定。 Visual Studio 2019 中升級精靈之檢閱方案動作對話方塊的螢幕擷取畫面,顯示 Visual Studio 2017 專案的重定目標選項 您也可以選擇使用 Visual Studio 2019 IDE 而不升級建置工具。若要這麼做,請在 檢閱方案動作 對話方塊中選取 取消。

手動將專案升級至 Visual Studio 2019

如果您想要直接編輯專案檔 (.vcxproj) 來升級專案,需要進行下列變更。
  1. 將 WindowsTargetPlatformVersion 新增至 Globals 屬性群組。將其值設為 10.0。以下是範例。
  1. 將所有 PlatformToolset 執行個體從 v141 變更為 v142。以下是範例。
  1. 重建專案。

clang/LLVM for Windows (ClangCl) 專案支援

Visual Studio 2019 也支援 clang/LLVM for Windows 開發。這需要安裝 C++ Clang-cl for Windows 與 C++ Clang-cl for v142 build tools (x64/x86) 這兩個個別元件。 如需詳細資訊,請參閱 Microsoft Game Development Kit (GDK) Clang 主題與 Microsoft Docs。

已知問題

  • 使用 /fp:fast 建置時,DirectXMath *IsNan 函式在 Visual Studio 2019 中可能會失敗。修正方式是搭配 DirectXMath 3.14 或更新版本使用 Visual Studio 2019 (16.3 或更新版本)。否則,您可以在使用這些函式的位置周圍放置 #pragma float_control 陳述式來因應此問題。
  • 在 v11 之前的 clang/LLVM for Windows 中,使用先行編譯標頭會有許多問題。視您的 PCH 與 C++ 範本使用方式而定,您可能需要新增 -fno-pch-instantiate-templates 才能成功建置。
  • 透過 Microsoft Update 提供的 .NET Core 更新可能會封鎖 Microsoft Game Development Kit (GDK) 安裝。若要解決此問題,請更新您的 Visual Studio 執行個體,或透過 Visual Studio 安裝程式解除安裝 Microsoft.NET.Core.Component.SDK.2.1 元件,然後重試安裝 (或解除安裝) Microsoft Game Development Kit (GDK)。

回報錯誤

Visual C++ 編譯器的錯誤報告應 (盡可能) 透過 Visual Studio 的 回報問題… 進行回報。請參閱 Microsoft Docs 與開發人員社群網站。請務必閱讀此頁面,以了解如何為編譯器建立良好錯誤報告的詳細資訊。
如果需要其他 NDA 資訊才能重現問題,您可以在公開報告問題中新增標示為「僅限 Microsoft」的註解。
若要回報 clang/LLVM for Windows 編譯器的錯誤,請使用 https://bugs.llvm.org/ 若要回報 Microsoft 標準 C++ 程式庫 (又稱 STL) 的錯誤,請使用 https://github.com/microsoft/STL/issues

另請參閱

PC 遊戲開發的 Visual Studio
最後修改於 2026年10月8日