CursorはVS Codeベースのエディタですが、一部の拡張機能はCursorの拡張機能マーケットプレイスで見つからないことがあります。そのような場合、VSIXファイルを使った手動インストールが有効です。この記事では、実際に「Copy With Line Numbers」拡張機能をインストールした例を基に、手順を解説します。

問題：コマンドラインインストールが失敗する

以下のようなコマンドラインからのインストールは、Cursorでは失敗することがあります：

cursor --install-extension yassh.copy-with-line-numbers
# Error: Extension 'yassh.copy-with-line-numbers' not found.

また、VSIXファイルをダウンロードしてもコマンドラインからのインストールでエラーが発生することがあります：

cursor --install-extension copy-with-line-numbers.vsix
# Error: End of central directory record signature not found.

解決方法：GUIからの手動インストール

ステップ1: VSIXファイルのダウンロード

  1. ブラウザで以下のURLパターンにアクセスします：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension-name}/{version}/vspackage

例：Copy With Line Numbersの場合

https://marketplace.visualstudio.com/_apis/public/gallery/publishers/yassh/vsextensions/copy-with-line-numbers/0.0.4/vspackage
  1. ファイルが自動的にダウンロードされます（通常は.vsix拡張子で保存されます）

ターミナルからダウンロードする場合：

curl -o copy-with-line-numbers.vsix "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/yassh/vsextensions/copy-with-line-numbers/0.0.4/vspackage"

ステップ2: Cursorへの手動インストール（推奨）

  1. Cursorを開く
  2. コマンドパレットを開く
    • Mac: Cmd+Shift+P
    • Windows/Linux: Ctrl+Shift+P
  3. 「Extensions: Install from VSIX...」と入力して選択
  4. ダウンロードしたVSIXファイルを選択
  5. インストール完了後、Cursorを再起動

ステップ3: インストールの確認

  1. 拡張機能パネル（左サイドバーの四角アイコン）を開く
  2. インストールされた拡張機能のリストで確認
  3. 機能を実際に試してみる

必要な情報の見つけ方

拡張機能IDの確認

VS Code Marketplaceのページで確認できます：

  • ページURL: https://marketplace.visualstudio.com/items?itemName={publisher}.{extension-name}
  • 右側の「More Info」セクションの「Unique Identifier」

最新バージョンの確認

  1. Marketplaceページの「Version History」タブをクリック
  2. 最新のバージョン番号を確認

トラブルシューティング

VSIXファイルが破損している場合

Error: End of central directory record signature not found.

解決策：

  • 再度ダウンロードを試す
  • ブラウザから直接ダウンロードする
  • GUIからのインストールを試す（コマンドラインではなく）

ファイルが見つからないエラー

Error: ENOENT: no such file or directory

解決策：

  • VSIXファイルのフルパスを指定する
  • ファイルが正しくダウンロードされたか確認する
  • GUIからのインストール方法を使用する

拡張機能が動作しない場合

  1. Cursorを完全に再起動
  2. 拡張機能の設定を確認
  3. 競合する拡張機能がないか確認

重要なポイント

コマンドラインよりGUIが確実

経験上、Cursorではコマンドパレット（Cmd+Shift+P）からの手動インストールが最も確実です。コマンドラインからのインストールは予期しないエラーが発生することがあります。

バージョン管理

  • 拡張機能のバージョンをメモしておく
  • 定期的に更新を確認する
  • 問題が発生した場合は、古いバージョンに戻すことも検討

実例：Copy With Line Numbersのインストール

この拡張機能は、ファイル名と行番号を含めてコードをコピーできる便利なツールです。

機能：

  • ショートカット: Ctrl+Shift+C
  • 出力形式：
File: /path/to/file.php
209: your code here

インストールURL：

https://marketplace.visualstudio.com/_apis/public/gallery/publishers/yassh/vsextensions/copy-with-line-numbers/0.0.4/vspackage

まとめ

Cursorで拡張機能が見つからない場合：

  1. VS Code MarketplaceからVSIXファイルをダウンロード
  2. Cmd+Shift+P → "Extensions: Install from VSIX..."
  3. ダウンロードしたファイルを選択

この方法なら、ほとんどのVS Code拡張機能をCursorで使用できます。コマンドラインでエラーが発生しても、GUIからの手動インストールなら成功する可能性が高いです。

参考リンク

この記事があなたの開発環境構築の助けになれば幸いです。同じ問題で困っている方は、ぜひこの方法を試してみてください。