1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【初心者向け】Godotの「外部エディター」をCursorにする(スクショ付き)

1
Last updated at Posted at 2026-02-27

外部エディターを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です。

スクリーンショット 2026-02-27 123007.png


2. 「エディター設定」を開く(日本語UI)

上部メニューから:

エディター → エディター設定

を開きます。

スクリーンショット 2026-02-27 124007.png


3. externalで検索して「外部」設定へ最短で移動

エディター設定の検索欄に external と入力します。
すると左側ツリーに次が出てきます。

  • テキストエディター
    • 外部

「外部」 を選択できれば目的地です。

スクリーンショット 2026-02-27 124147.png

スクリーンショット 2026-02-27 124311.png


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} を外部エディタに渡してくれるとは限らないため、
「行番号までピッタリ飛ぶ」は環境・操作(どこから開いたか)によって動作が変わります。
私の環境では、ファイルは確実に開けましたが、エラー一覧からの行番号ジャンプはできませんでした。


✅ ここまで設定できたら完成です。

スクリーンショット 2026-02-27 125255.png


5. 動作確認:Godotから.gdを開いてCursorが起動するか

Godotに戻ってファイルシステムの、.gd をダブルクリックします。

スクリーンショット 2026-02-27 142939.png

成功すると、Cursorが起動して該当ファイルが開きます。

スクリーンショット 2026-02-27 143034.png


実行パスが分からなかった話(私が詰まったポイント)

今回、私が一番詰まったのはこれでした。

「実行パス? Cursor.exe? どこ??」

結論、タスクマネージャーから実行ファイルの場所を開くのが一番確実でした。

解決手順(Windows)

  1. Cursorを起動する
  2. タスクマネージャーを開く(Ctrl + Shift + Esc
  3. プロセス一覧でCursorを右クリック
  4. 「ファイルの場所を開く」
  5. 表示されたフォルダ内の Cursor.exe を指定(パスをコピーしてGodotに貼る)

この手順で、私の環境では
C:\Program Files\cursor\Cursor.exe が実行パスだと分かりました。


GodotからCursorを開くメリット

「Cursorで編集してGodotで確認する」運用をしている人だと、
GodotからCursorを開く意味が分かりにくいと思うかもしれません。

これは「編集が速くなる」というより、迷子と往復が減るのがメリットです。

1) どのスクリプトを直すべきか迷わない(ファイル迷子が消える)

プロジェクトが少し大きくなると、こういう迷いが増えます。

  • 「このボタンの処理、どの.gdだっけ?」
  • 「同じ名前のui.gdが複数ある…」
  • 「このノードに付いてるスクリプト、どこ?」

Godotから開くと “今触っているノードに紐づいた正解のファイル” に一発で到達できます。
検索で探す時間が削れて、地味に効きます。

2) デバッグ中の往復が短くなる(地味に効く)

実装中はこのループが多いです。

  1. Godotで挙動を見る / エラーを見る
  2. 該当スクリプトを開く
  3. 修正して保存
  4. Godotで再実行して確認

②の「該当スクリプトを開く」が毎回検索スタートだと疲れます。
Godot→Cursorを一発で開けると、往復が最短になります。

よくあるつまづきポイント集

つまづき1:Cursorが起動しない

上から順に確認すればOKです。

  1. 「外部エディターを使用」がオンか?
  2. 実行パスが 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側の操作によっては行番号が渡らず、エラー一覧クリックで外部ジャンプはできないことがある
  • 外部エディターにするメリットは「編集が速い」より、どのファイルを直すか迷う時間とデバッグの往復を減らせること
1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?