快速入門：Visual Studio Tools for Unreal Engine

發行項
01/26/2025

在本文中，下載 Unreal Engine （UE）遊戲範例，並設定 Visual Studio Tools for Unreal Engine。 Visual Studio Tools for Unreal Engine 是免費的擴充功能，可協助您使用 Unreal Engine 開發遊戲。它提供可改善 Visual Studio 中 Unreal Engine 開發體驗的功能。

先決條件

必須安裝下列項目：

Visual Studio 17.10 版或更新版本。
Unreal Engine 第 5 版或更新版本，因為本文中使用的範例需要 Unreal Engine 5 或更新版本。
Visual Studio Tools for Unreal Engine。如需安裝指示，請參閱安裝 Visual Studio Tools for Unreal Engine。

在 Visual Studio 中下載並建置 Lyra 遊戲範例

Lyra 是學習 Unreal Engine 的範例遊戲專案。如需下載指示，請參閱 Lyra 範例遊戲的 下載 Lyra 入門遊戲 一節。如果您透過 Unreal Engine 的原始程式碼安裝取得該版本，該版本不包含建置和執行遊戲所需的資產。使用下載指南，透過 Epic 安裝程式獲取全部所需內容。

設定 Lyra 遊戲範例以使用 Visual Studio Tools for Unreal Engine

自 Visual Studio 2022 17.7 版起，Visual Studio Tools for Unreal Engine 外掛程式隨附於 Unreal Engine 安裝中。不再需要檢視 Unreal Engine 藍圖。如果您有舊版的 Visual Studio，請參閱安裝 Visual Studio Tools for Unreal Engine 手動安裝外掛程式。

下載遊戲範例之後，請更新 LyraStarterGame.uproject 以使用Visual StudioTools外掛程式。其中一種方法是在 Unreal 編輯器中。載入 Lyra 專案，然後從主選單選擇 [編輯>外掛程式]。尋找 Visual Studio Integration Tools 外掛程式，然後核取其旁邊的方塊。

另一種方法是手動編輯 LyraStarterGame.uproject 檔案。方法如下：

在文字編輯器中開啟 LyraStarterGame.uproject 檔案。它位於您安裝遊戲範例的目錄中。

將下列內容新增至 Plugins 區段結尾：

,{
    "Name": "VisualStudioTools",
    "Enabled": true
}

在 Unreal Engine 中

在 Unreal Engine 中開啟 Lyra 專案。
從 Unreal Engine 編輯器主功能表中，選擇 [工具]>[產生 Visual Studio 專案]。這會建立 Visual Studio 的解決方案檔。
從 Unreal Engine 編輯器主功能表中，選擇 [[工具]>[開啟 Visual Studio] 以在 Visual Studio 中開啟遊戲。如果您的計算機上有多個 Visual Studio 版本，請確定已開啟正確的版本：從 Visual Studio 主功能表中，選擇 [說明]>[關於Microsoft Visual Studio]。您必須使用 Visual Studio 2022 17.7 版或更高版本。如果正確的版本未開啟，請以正確的 Visual Studio 版本手動開啟 LyraStarterGame.sln。

在 Visual Studio 中

將 [解決方案組態] 下拉式清單變更為 [開發編輯器]。這會啟用藍圖 Visual Studio Tools for Unreal Engine：
將啟動項目設定為 LyraStarterGame 專案。在 [方案總管]中，以滑鼠右鍵按一下方案，然後選擇 [屬性]。
在 [方案屬性頁] 對話框的 [[一般屬性]下，選擇 [設定啟始專案]。
確定已選取 [單一啟動專案]，然後在下拉式清單中選擇 [LyraStarterGame]。

在 [通用屬性] 底下，選取 [設定啟始專案]。已選取「單一啟動專案」單選按鈕。下拉式清單中的啟動專案是LyraStarterGame。
選擇 [確定] 關閉對話框。
從 Visual Studio 主選單中，選擇 [建置>建置方案] 來建置遊戲。

Visual Studio 建置輸出視窗

Visual Studio 中的 [建置輸出] 視窗會顯示組建進度，以及任何發生的錯誤或警告。您可以從 Visual Studio 主選單開啟 [建置輸出] 視窗，[檢視]>[輸出]。

從 Visual Studio 2022 17.12 開始，您可以在輸出視窗中按兩下檔案的絕對路徑，以在 Visual Studio 中開啟該檔案。原始碼必須是Visual Studio解決方案的一部分，而輸出視窗中的路徑必須是絕對路徑。這適用於在Visual Studio或其他類型的專案中建置 Unreal Engine 專案時。

下列螢幕快照顯示 LyraStarterGame 範例組建的輸出視窗。用戶雙擊了來自 LyraCharacter.generated.h的警告。因為提供該檔案的絕對路徑，因此檔案會在編輯器中開啟。

Visual Studio 提供一個工具列，可改善 Visual Studio 中的 Unreal Engine 開發整合體驗。工具列可讓您快速存取一般 UE 工作。

從主選單中啟用 Visual Studio 的 Unreal Engine 工具列，[檢視]>[工具列]，>Unreal Engine。工具列看起來如下：

Visual Studio 中 Unreal Engine 工具列的螢幕快照。

工具列按鈕，由左至右：

播放圖示是一個快速附加按鈕，會附加至右側下拉式清單中所列的進程。下拉式清單列出 Unreal Engine 相關程式，讓您更輕鬆地附加至 Unreal Engine 編輯器。您也可以使用此附加至任何程序。
啟動和停止 Unreal Engine 整合伺服器的按鈕。整合伺服器可改善 Unreal Engine 與 Visual Studio 整合的效能。它會以背景程式的形式執行，並在您處理專案時自動更新測試資訊。您可以將其關閉以回收計算機資源，並在您想要整合改善時啟動它。當您在 Visual Studio 中開啟 UE 專案時，會自動啟動伺服器。
重新掃描 Unreal Engine 藍圖資產的按鈕。這會使用 Unreal Engine 專案的最新藍圖資產來更新 Visual Studio 解決方案。
開啟 Unreal Engine 記錄視窗的按鈕。
開啟 [Unreal Engine 整合組態] 視窗的按鈕，您可以在其中重新整理並查看整體組態狀態和 Visual Studio 整合工具狀態、檢查藍圖支援、查看是否取得 Unreal Engine 命名慣例檢查程序狀態等等。

在內部循環的編輯和偵錯過程中，您可能會經常使用不同的命令行自變數組合來啟動遊戲。這現在變得更容易，因為有命令列參數下拉式清單：

指令列參數下拉式清單的螢幕快照。

若要新增命令行自變數，請在下拉式清單中輸入它們，然後按 Enter。自變數會以您輸入自變數的順序儲存，並出現在下拉式清單中以供日後使用。

在移除最舊命令行之前，您可以新增五個命令行的限制，以騰出空間供新的命令行使用。

偵錯在 Unreal Engine 編輯器中執行的 Unreal Engine 專案時，第一個自變數必須是項目的路徑。例如：C:\UE\LyraStarterGame\LyraStarterGame.uproject。

如需使用命令行自變數下拉式清單的詳細資訊，請參閱偵錯時傳遞命令行自變數 C++。

後續步驟

在 Visual Studio 中新增 Unreal Engine 類別、模組和外掛程式
在 Visual Studio 中檢視 Unreal Engine 藍圖
 在 Visual Studio 中檢視 Unreal Engine 記錄
 在 Visual Studio 中檢視 Unreal Engine 巨集

共用方式為