Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Visual Studio

Visual Studio Community 是 Microsoft 推出的僅限 Windows 的 IDE，個人或組織非商業用途可免費使用。它具備許多實用功能，如記憶體檢視、效能檢視、版本控制等。

備註

本文檔用於說明如何貢獻遊戲引擎，而不是教你把 Visual Studio 當作 C# 編輯器使用。若要在外部編輯器撰寫 C#，請見 C# 外部編輯器設定指南。

匯入專案

Visual Studio 需要 solution 檔（.sln）才能開發專案。雖然 Godot 預設沒有附 solution 檔，可以透過 SCons 產生。

• 前往 Godot 根目錄並開啟命令提示字元或 PowerShell 視窗。

• 執行 scons platform=windows vsproj=yes dev_build=yes 來產生含偵錯符號的 solution。

  vsproj 參數用來要求產生 Visual Studio solution。

  dev_build 參數可讓建置檔案包含偵錯符號，方便你用斷點逐步除錯程式碼。

• 你現在可以直接在專案根目錄雙擊 godot.sln 開啟，或於 Visual Studio 內選擇 Open a project or solution 開啟。

• 使用上方選單的 Build 來建置專案。

警告

必須於安裝 Visual Studio 時選取 C++ 套件，於安裝程式內可勾選安裝：

除錯專案

Visual Studio 內建強大的偵錯工具，可讓你檢查 Godot 原始碼、在指定位置中斷、檢查執行狀態，也能即時修改程式內容。

你可以從上方選單 Debug > Start Debugging （啟動偵錯）直接用偵錯器執行專案。但如果你想直接偵錯 Godot 編輯器（而不是專案管理員），需先手動設定啟動參數，因為專案管理員開啟專案後會終止原本的執行程序，導致偵錯器自動退出。

• 要設定偵錯器啟動選項，請於上方選單點選 Project > Properties：

• 於 Debugging 區段的 Command Arguments 欄位，加入兩個參數：「-e」代表直接開啟編輯器（不經專案管理員），「--path」指定要開啟的專案（需填寫專案根目錄的 絕對路徑，而非 project.godot 檔名；若路徑含空格請加雙引號）。

更多命令列參數資訊請參考 命令列教學。

即使沒有從一開始用偵錯器啟動專案，也能在執行中時以 Debug > Attach to Process... （附加至處理序）功能連接現有程序進行除錯。

要確認一切運作正常，請在 main.cpp 設斷點後，按 F5 啟動偵錯。

如遇問題，歡迎到 Godot 社群頻道 求助。