外部エディターをCursorに設定して、Godotから対象のスクリプトを一発で開く
Godotの内蔵スクリプトエディターでも開発はできますが、プロジェクトが少し育つとこうなりがちです。
- 「このノードの処理、どの
.gdだっけ?」(ファイル迷子) - 「デバッグ中に Godot→エディタ→Godot の往復が増える」
- 「検索で探すより、今触ってるノードのスクリプトを即開きたい」
また、
- 検索
- 置換・リネーム
- AI補助
をそのまま使いたくて、Godotの外部エディターをCursorに設定し、
Godotで.gdを開いたら、Cursorでそのファイルが開くようにしました。
この記事でできるようになること(ゴール)
- ✅ Godotで
.gdをダブルクリック - ✅ Cursorが起動
- ✅ 該当ファイルが開く(行番号ジャンプも狙える)
動作環境(検証環境)
- OS:Windows 11 Pro(25H2)
- OS ビルド:26200.7840
- Windows 機能エクスペリエンス パック:1000.26100.291.0
- インストール日:2025/05/26
- Godot:4.6 stable(日本語UI)
- Cursor:2.3.21(system setup)
- VSCode Version:1.105.1
- OS:Windows_NT x64 10.0.26200
手順(スクショ付き)
0. 事前準備
- Cursorをインストール
- Godotをインストール
- Godotプロジェクト(
project.godotがあるフォルダ)を用意
1. Godotでプロジェクトを開く
まずは普通に対象プロジェクトを開きます。
SceneツリーやFileSystemが見えていればOKです。
2. 「エディター設定」を開く(日本語UI)
上部メニューから:
エディター → エディター設定
を開きます。
3. externalで検索して「外部」設定へ最短で移動
エディター設定の検索欄に external と入力します。
すると左側ツリーに次が出てきます。
- テキストエディター
- 外部
「外部」 を選択できれば目的地です。
4. 外部エディターをCursorに設定する(ここが本体)
ここで設定するのは3つだけです。
4-1) 外部エディターを使用:オン
チェックを入れます。
(ここがOFFだと、何を設定しても動きません)
4-2) 実行パス:Cursor.exeを指定
私の環境ではここでした。
C:\Program Files\cursor\Cursor.exe
⚠️ ここが人によって違うので、もし分からない場合は後述の「実行パスが分からなかった話」を使うのが確実です。
4-3) 実行フラグ:Cursorに「開くファイル」を渡す(※行番号ジャンプは“できる場合がある”)
ここにこれを入れます。
{project} --goto "{file}:{line}:{col}"
ざっくり何をしている?
-
{project}:プロジェクトのパス(Cursorにプロジェクトとして開かせるために渡す) -
{file}:開きたいファイル -
{line}{col}:行/列(カーソル位置) -
--goto:VSCode系(Cursor含む)が「ファイルを開く/指定行へ移動する」ためのオプション
補足:Cursor側は
--goto "ファイル:行:列"に対応しています。
ただし Godot側が常に{line}{col}を外部エディタに渡してくれるとは限らないため、
「行番号までピッタリ飛ぶ」は環境・操作(どこから開いたか)によって動作が変わります。
私の環境では、ファイルは確実に開けましたが、エラー一覧からの行番号ジャンプはできませんでした。
✅ ここまで設定できたら完成です。
5. 動作確認:Godotから.gdを開いてCursorが起動するか
Godotに戻ってファイルシステムの、.gd をダブルクリックします。
成功すると、Cursorが起動して該当ファイルが開きます。
実行パスが分からなかった話(私が詰まったポイント)
今回、私が一番詰まったのはこれでした。
「実行パス? Cursor.exe? どこ??」
結論、タスクマネージャーから実行ファイルの場所を開くのが一番確実でした。
解決手順(Windows)
- Cursorを起動する
- タスクマネージャーを開く(
Ctrl + Shift + Esc) - プロセス一覧でCursorを右クリック
- 「ファイルの場所を開く」
- 表示されたフォルダ内の
Cursor.exeを指定(パスをコピーしてGodotに貼る)
この手順で、私の環境では
C:\Program Files\cursor\Cursor.exe が実行パスだと分かりました。
GodotからCursorを開くメリット
「Cursorで編集してGodotで確認する」運用をしている人だと、
GodotからCursorを開く意味が分かりにくいと思うかもしれません。
これは「編集が速くなる」というより、迷子と往復が減るのがメリットです。
1) どのスクリプトを直すべきか迷わない(ファイル迷子が消える)
プロジェクトが少し大きくなると、こういう迷いが増えます。
- 「このボタンの処理、どの
.gdだっけ?」 - 「同じ名前の
ui.gdが複数ある…」 - 「このノードに付いてるスクリプト、どこ?」
Godotから開くと “今触っているノードに紐づいた正解のファイル” に一発で到達できます。
検索で探す時間が削れて、地味に効きます。
2) デバッグ中の往復が短くなる(地味に効く)
実装中はこのループが多いです。
- Godotで挙動を見る / エラーを見る
- 該当スクリプトを開く
- 修正して保存
- Godotで再実行して確認
②の「該当スクリプトを開く」が毎回検索スタートだと疲れます。
Godot→Cursorを一発で開けると、往復が最短になります。
よくあるつまづきポイント集
つまづき1:Cursorが起動しない
上から順に確認すればOKです。
- 「外部エディターを使用」がオンか?
- 実行パスが
Cursor.exe本体になっているか?(ショートカットではない)
つまづき2:Cursorは起動するけど、ファイルが開かない
実行フラグのミスが多いです。これに戻せばOK。
{project} --goto "{file}:{line}:{col}"
つまづき3:Godot側で.gdを開いても「内蔵エディター」で開いてしまう
「外部エディターを使用」がOFFになっていないか確認
変更したのに反映されないときは、Godotを一度再起動すると直ることがあります
まとめ
- Godot 4.6 / Windows では、「エディター設定 → テキストエディター → 外部」 から外部エディターを設定できる
- 私の環境で再現できた“安定ルート”は 左下の「ファイルシステム」から
.gdを開く方法(ここからはCursorが起動してファイルが開いた) - Cursor設定のキモは2つ
- 実行パス:
C:\Program Files\cursor\Cursor.exe(分からない時はタスクマネージャー→「ファイルの場所を開く」が最短) - 実行フラグ:
{project} --goto "{file}:{line}:{col}"(パスにスペースが入る可能性があるので引用符付きが安全)
- 実行パス:
-
--goto自体はCursor側で有効(PowerShellの--goto "ファイル:行:列"で行番号ジャンプを確認できた)
※ただしGodot側の操作によっては行番号が渡らず、エラー一覧クリックで外部ジャンプはできないことがある - 外部エディターにするメリットは「編集が速い」より、どのファイルを直すか迷う時間とデバッグの往復を減らせること






