JetBrains IDEとCursorを少しでもシームレスに併用したい方に！

![2025-04-2917.09.22-ezgif.com-video-to-gif-converter.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/591019/9edf1588-761b-4649-ba77-2d7c5c21522b.gif)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/591019/802f04d8-79e5-4d14-8c45-6e60a2d8ce53.png)

## 🌟 はじめに - 「併用がしたい！」

Cursorすごいですね。私も2つのProアカウントを契約して使い倒しています。会社アカウントと個人アカウント。
SEというかなんといいますか、要件定義〜設計〜開発〜テスト〜リリース計画まで、一貫した動きをしていて、すべてにおいて活用しています。エンジニア的な動きにも、ディレクターやマネジメント的な動きにも、ということです。
Cursorが非エンジニアとしてもいいとか、PM業務に有効だとか、そういうことはたくさんの方々が公開されている記事に譲らせていただければと思いますが

**正直、個人的には、UIUXはJetBrains IDEが上回っていると感じて（あるいは長年の愛着でそう感じさせられて）います。**

なんかね〜。。Cursor（vscode）はMicrosoft側で、なんとなくWindowsっぽい印象。
拡張機能たくさん入れて設定ごりごりjsonで記述してカスタマイズしないと、本格的な開発には向かないかもしれない点が。
JetBrains IDEはAppleっぽい。ユーザーファーストなんですよね。プラグインの概念はありますが、ビルトインでほぼ完ぺきにパッケージングされている。
思想・宗教的な話になっちゃうので、個人の感想ですレベルに留めないといけないお話ですが。

私はエンジニア歴としてはPHPer歴が比較的長く、そのキャリアスタートからPhpStormを愛用しています。
CursorなどのAIエージェント・エディタの有効性もよ〜くわかる。わかります！
でも強力な静的解析とかダブルShiftのなんでもござれ検索機能とかは、どうあがいてもPhpStormに勝ててないよな〜〜〜と日々悶々。
そんな中で出合った下記記事。

### Thanks for the reference!

https://zenn.dev/leaner_dev/articles/ed31fc82f02505

わ〜か〜るぅ〜。共感の嵐。
ということで、私も一瞬PhpStormの解約をしようとしていた手を止め、決めました。併用！


# :head_bandage:  地味に困っていたこと

Cursorといっしょに要件整理したり設計したり開発したり（厳密にはCursorではプログラミングはせず、すべてやらせます）。で、じゃーちょっと自分で手を動かしますか、ということで、たまにファイル検索や手直しでPhpStormをカチャカチャ。その交互のくりかえしの光景が、私のデスク上でくり広げられます。
・・・ーーん〜、いや、**イチイチそれぞれのエディタでファイル検索して開くのめんどいなあ！**
1日数十〜数百回のくり返し作業ですもの。そんな中で下記記事との出合い。

### Thanks for the reference!

https://qiita.com/yoshinyan/items/3b1e3beab9da96f3749d

## 📋 この記事でわかること

- Cursorで開いているファイルをJetBrains IDEで開く方法
- JetBrains IDEで開いているファイルをCursorで開く方法
  - ※ 私がPhpStormerなので、今回はPhpStormを例にとります
- macOS環境での具体的な設定手順
- トラブルシューティング方法

## :family_wwbb: 想定対象読者

- JetBrains IDEとCursorを少しでもシームレスに併用したい人（ニッチ！w）

## 📝 前提条件

- macOS環境（このガイドはmacOS向けに作成しています）
- Cursor エディタがインストール済み
- PhpStorm（または他のJetBrains IDE）がインストール済み
- JetBrains Toolbox App

## 🔄 Cursorで今開いているファイルをPhpStormで開く

### 1. JetBrains Toolboxのインストール

※上記参考記事で紹介されている方法ですね。ただ、実際にやってみてわからない点もあったので、私なりにあらためて整理を。

:::note warn
**重要**: コマンドライン起動ツールを使用するには、JetBrains Toolboxが必要です
:::

1. [JetBrains Toolbox公式サイト](https://www.jetbrains.com/toolbox-app/)からToolbox Appをダウンロード
2. ダウンロードしたインストーラーを実行
3. PhpStormをインストールまたは既存のインストールを登録

### 2. コマンドラインツールの有効化

<details>
<summary>📌 コマンドラインツールの有効化手順（クリックして展開）</summary>

1. JetBrains Toolbox Appを起動
2. 右上の歯車アイコン⚙️をクリック
3. 「設定」を選択
4. 「ツール」セクションを探す
5. 「シェルスクリプトの生成」オプションを有効にする
   
これにより、`phpstorm`コマンドなどがシステムパスに追加されます。
</details>

### 3. Cursorタスク設定

プロジェクトのルートに`.vscode/tasks.json`ファイルを作成し、以下の内容を追加します：

```json
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Open Current File in PhpStorm",
            "type": "shell",
            "command": "phpstorm",
            "args": [
                "${file}"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}
```

:::note info
**使用方法**: コマンドパレット（`Cmd+Shift+P`）を開き、「Tasks: Run Task」を選択し、「Open Current File in PhpStorm」を選択するだけです
:::

### 4. トラブルシューティング

とくにこちらが私が実際に遭遇したエラーです。

| エラー | 原因 | 解決策 |
|-------|------|--------|
| `変数 ${file} を解決できません。エディターを開いてください。` | ファイルが正しく開かれていない | 編集中のファイルを開いた状態でタスクを実行 |
| `command not found: phpstorm` | コマンドラインツールが有効化されていない | JetBrains Toolboxの設定を確認 |

---

## 🔄 PhpStormで今開いているファイルをCursorで開く

”CursorからPhpStorm”はできたけど、一方向じゃ価値半減だな〜ということで調べました。簡単。

### 1. Cursorパスの確認

ターミナルで以下のコマンドを実行して、Cursorの実行ファイルのパスを確認します：

```bash
find /Applications -name "Cursor*" -type f -perm +111
```

:::note info
一般的なパスは `/Applications/Cursor.app/Contents/MacOS/Cursor` のはずです
:::

### 2. PhpStorm外部ツール設定

1. PhpStormを起動
2. メニューから `Preferences` → `Tools` → `External Tools` を選択
3. `+` ボタンをクリックして新しいツールを追加
4. 以下のように設定：

```
Name: Open in Cursor
Program: /Applications/Cursor.app/Contents/MacOS/Cursor
Arguments: $FilePath$
Working directory: $ProjectFileDir$
```

### 3. キーボードショートカット設定（オプション）

外部ツールをより簡単に使用するために、キーボードショートカットを割り当てることができます：

1. `Preferences` → `Keymap` を開く
2. `External Tools` → `External Tools` → `Open in Cursor` を検索
3. 右クリックして `Add Keyboard Shortcut` を選択
4. 任意のショートカットを入力（例: `Ctrl+Alt+C`）

:::note alert
ショートカットが他のコマンドと競合しないよう注意してください
:::

### 4. トラブルシューティング

<details>
<summary>🔧 トラブルシューティングガイド</summary>

**エラー**: Cursorが起動しない

**解決策**:
1. パスが正しいことを確認
2. ターミナルで直接Cursorコマンドを実行できるか確認
3. 権限の問題がないか確認

```bash
# 直接実行できるか確認
/Applications/Cursor.app/Contents/MacOS/Cursor ~/path/to/your/file.php
```
</details>

## 📝 まとめ

CursorとPhpStormを相互に連携させる方法をまとめてみました。
おもなポイントは：

1. **Cursor → PhpStorm連携**
   - JetBrains Toolboxのインストールが必須
   - コマンドラインツールの有効化
   - `.vscode/tasks.json`の設定

2. **PhpStorm → Cursor連携**
   - Cursorの正確なパスの確認
   - PhpStormの外部ツール機能の活用
   - キーボードショートカットの設定

自己満足の意味合いもけっこうありますw 一応社内LTでも紹介はしてみましたが、あまりウケてなかったなーと思いつつ、でも本当に自己満足しています。