Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

CLion

CLion 是用於 C++ 的商業版 JetBrains IDE。

匯入專案

CLion 可以匯入專案的編譯資料庫檔案<https://clang.llvm.org/docs/JSONCompilationDatabase.html>`_，通常名稱為「compile_commands.json」。若要產生編譯資料庫檔案，請開啟終端，切換到Godot根目錄，然後執行：

scons compiledb=yes

然後，使用 CLion 開啟 Godot 根目錄。 CLion 將匯入編譯資料庫、索引程式碼庫，並提供自動完成和其他進階程式碼導覽和重構功能。

對專案進行除錯

CLion 不支援開箱即用地透過 SCons 編譯和除錯 Godot。這可以透過在 CLion 中建立自訂建置目標和運作配置來實作。在建立自訂建置目標之前，您必須在命令列上編譯 Godot <toc-devel-compiling>` 一次，以產生 Godot 執行檔。開啟終端，切換到Godot根目錄，然後執行：

scons dev_build=yes

若要新增呼叫 SCons 進行編譯的自訂建置目標：

• 開啟 CLion 並導覽至 首選項 > 建置、執行、部署 > 自訂建置目標

• 按一下“新增目標”並為目標命名，例如“Godot debug”。

• 按一下 Build: 選擇方塊旁的 ...，然後按一下 External Tools 對話方塊中的 + 按鈕以新增新的外部工具。

• 為工具命名，例如“Build Godot debug”，將 Program 設定為“scons”，將 Arguments 設定為您想要的編譯設定（請參閱:ref:編譯 Godot <toc -devel -compiling>)，並將**工作目錄** 設定為``$ProjectFileDir$``，它等於Godot 根目錄。按一下 確定 建立該工具。

  備註

  CLion 不會擴充諸如「scons -j$(nproc)」之類的 shell 指令。請使用具體值，例如“scons -j8”。

• 返回 外部工具 對話框，再次按一下 + 以新增第二個外部工具，用於透過 SCons 清理 Godot 建置。為該工具命名，例如“Clean Godot debug”，將 Program 設為“scons”，將 Arguments 設為“-c”（這將清理建置），然後將**工作目錄* * 設定為``$ProjectFileDir$``。按一下 確定 建立該工具。

• 關閉**外部工具**對話框。在自訂「Godot debug」建置目標的 Custom Build Target 對話方塊中，從 Build 選擇方塊中選擇 Build Godot debug 工具，然後選擇 Clean Godot debug ** * *清潔 選擇框中的工具。按一下 確定 建立自訂建置目標。

• 在主 IDE 視窗中，按一下「新增配置」。

• 在 執行/偵錯配置 對話方塊中，按一下 新增...，然後選擇 自訂建置應用程式 以建立新的自訂運作/偵錯配置。

• 為運作/偵錯配置命名，例如“Godot debug”，選擇“Godot debug”自訂建置目標作為**目標**。選擇“bin/”資料夾中的Godot可執行檔作為**可執行檔**，並將**程式參數**設為“--editor --path path-to-your-project/”，其中``path-to-your-project/``應該是指向現有Godot專案的路徑。如果省略「--path」參數，您將只能偵錯 Godot 專案管理器視窗。按一下 確定 建立運作/偵錯配置。

現在您可以透過執行設定來建置、運作、偵錯、分析和檢查 Godot 編輯器。

播放場景時，Godot 編輯器將產生一個單獨的程序。您可以在CLion 中偵錯此程序，方法是前往**Run > Attach to process...**，輸入``godot``，然後選擇具有最高**pid**（程序ID）的Godot 程序，這將通常是正在運作的專案。