How to use Cursor AI in Godot
上一篇介紹了如何在 Unity 中使用 Cursor AI，這篇換成遊戲開發者常用的 Godot。Cursor 是一個 AI 程式編輯器（基於 VS Code 打造），能幫你補碼、生成與修改程式。在 Godot 中主要用來撰寫 GDScript 或 **C#**，讓 AI 參與腳本開發。
與 Unity 不同的是，Godot 不需要安裝任何套件，只要在設定裡把 Cursor 設成「外部編輯器」即可。以下分 Mac 與 Windows 兩種平台說明。
步驟一：安裝 Cursor
- 前往 https://www.cursor.com/ 註冊帳號並下載對應作業版本的
Cursor安裝。 - 開啟後登入，建議先到設定裡選好要用的模型（例如 Claude、GPT 等）。
步驟二：將 Cursor 設為 Godot 的外部編輯器
- 在 Godot 4 編輯器右上角，點擊
Editor->Editor Settings（或直接按Ctrl+,／⌘+,）。 - 在左側展開
General，找到Text Editor，再點開External。 - 勾選
Enabled，讓 Godot 允許用外部程式開啟腳本。 - 設定
Exe/Path（Cursor 的執行檔路徑）與Args（傳遞給 Cursor 的參數）。
Mac 使用者
Exe/Path填入：1
/Applications/Cursor.app/Contents/MacOS/cursor
Args填入：1
{file}:{line}
Windows 使用者
Exe/Path填入cursor.exe的路徑。如果不知道裝在哪，可以到「開始選單」找到 Cursor、右鍵選擇「開啟檔案所在位置」，即可看到執行檔，再把完整路徑複製過來。Args同樣填入：1
{file}:{line}
參數說明：
{file}會被替換成腳本檔案的完整路徑，{line}則是你在 Godot 中游標所在的行號。這樣 Cursor 開啟時會直接定位到該行。
- 回到
Text Editor上層，把External -> Use External勾選起來，確保生效。 - 點擊右下角的
Apply、OK完成設定。
步驟三：在 Godot 中開啟腳本
- 在場景樹或檔案系統中，雙擊一支 GDScript／C# 腳本，它會在 Godot 內建的編輯器打開。
- 點擊右上角的「用外部編輯器開啟」圖示（看起來像一支筆或外框箭頭），Godot 就會呼叫 Cursor 在同一支檔案上打開。
- 之後每次改腳本，只要點該圖示，就會直接用 Cursor 開啟，方便直接使用 AI 功能。
替代做法：直接用 Cursor 開啟整個專案
如果你希望 AI 能理解整個 Godot 專案的上下文（而不只是單一腳本），可以直接用 Cursor 打開專案資料夾：
- 在 Cursor 中點擊
Open Folder，選擇你的 Godot 專案資料夾（包含project.godot的那一層）。 - 此時 Cursor 會把整個專案當作品程開啟，AI 能讀取所有腳本、資源與結構。
- 改完後回到 Godot，腳本通常會自動偵測到變更；若沒更新，按右鍵選擇
Reload即可。
這種方式適合想讓 AI 跨檔案理解邏輯、進行重構或除錯的情境。
使用 Cursor 的 AI 功能
開啟腳本後，你可以用以下快捷鍵呼叫 AI：
⌘+L（Mac）／Ctrl+L（Windows）：開啟 AI 對話視窗。你可以在這裡向 AI 闡述問題或需求，讓它生成、解釋或修改程式碼。⌘+K（Mac）／Ctrl+K（Windows）：在你選中的段落上直接改寫。先選取一段程式，再按快捷鍵並描述你想做的變更。- **
Tab**：行內補碼。輸入部分邏輯時，Cursor 會建議接下來的內容，按Tab接受。
小結
- Godot 4 不需要套件，只要在
Editor Settings -> Text Editor -> External把 Cursor 設成外部編輯器。 - Mac 路徑為
/Applications/Cursor.app/Contents/MacOS/cursor；Windows 則指向cursor.exe，參數都用{file}:{line}。 - 想讓 AI 理解全專案，可以直接用 Cursor 開啟整個 Godot 資料夾。
- 常用快捷鍵：
L（對話）、K（選取改寫）、Tab（補碼）。
如果你也用 Unity，可以參考上一篇〔How to use Cursor AI in Unity〕(/2024/09/22/2024-09-22-how-to-use-cursor-ai-in-unity/)，兩者的核心概念相同，只是設定位置不同。
《AI 新時代》系列第 13 篇。上一篇：AI 趨勢倫理 · 相關：Cursor in Unity