Visual Studio Code

Visual Studio Code is a free cross-platform code editor by Microsoft (not to be confused with Visual Studio).

匯入專案

  • 請確定有安裝 C/C++ 延伸模組。可以在 官方說明文件 (英語) 中瞭解詳細說明。

  • 從 Visual Studio Code 的主畫面中通過 檔案 > 開啟資料夾... 來開啟 Godot 根目錄。

  • 按一下 Ctrl + Shift + P 來開啟命令選擇區,並輸入 Configure Task (設定工作)。

../../../_images/vscode_configure_task.png
  • 選擇 從範本建立 tasks.json 檔案 選項。

../../../_images/vscode_create_tasksjson.png
  • 接著選擇 Others

../../../_images/vscode_create_tasksjson_others.png
  • tasks.json 檔案中,找到 "tasks" 陣列,並在其中新增一段新的內容:

{
  "label": "build",
  "type": "shell",
  "command": "scons",
  "group": "build",
  "args": [
    "platform=x11", // Change to your current platform
    "target=debug",
    "-j4"
  ],
  "problemMatcher": "$msCompile"
}
../../../_images/vscode_3_tasks.json.png

填寫 tasks.json 的範例。

依據各種不同的設定與需求,可以使用不同的引數。有關完整的引數列表,請參考 建置系統簡介

對專案進行除錯

要執行並對專案進行除錯,則需要在 launch.json 檔案中建立一個新的設定。

  • 按一下 Ctrl + Shift + D 來開啟 [執行] 面板。

  • 若沒有 launch.json 檔案,則會顯示建立新檔案的提示。

../../../_images/vscode_1_create_launch.json.png
  • 選擇 C++ (GDB/LLDB) 。此處可能會出現其他平台特定的選項。選擇後,請依據提供的範例來調整設定。

  • launch.json 檔案中,找到 "configurations" 陣列並在其中新增一段新的內容:

{
  "name": "Launch",
  "type": "cppdbg",
  "request": "launch",
  // Change the path below to match your current platform.
  "program": "${workspaceFolder}/bin/godot.x11.tools.64",
  // Change the arguments below for the project you want to test with.
  // To run the project instead of editing it, remove the "--editor" argument.
  "args": [ "--editor", "--path", "path-to-your-godot-project-folder" ],
  "stopAtEntry": false,
  "cwd": "${workspaceFolder}",
  "environment": [],
  "externalConsole": true,
  "MIMode": "gdb",
  "setupCommands": [
    {
      "description": "Enable pretty-printing for gdb",
      "text": "-enable-pretty-printing",
      "ignoreFailures": true
    }
  ],
  "preLaunchTask": "build"
}
../../../_images/vscode_2_launch.json.png

填寫 launch.json 的範例。

program 中的名稱會依據建置設定而有所不同,如有開啟 tools 的 64 位元 X11 版為 godot.x11.tools.64

若遇到任何問題,請在 任何一個 Godot 的社群頻道 中尋求幫助。