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ファイルのダウンロード
- ブラウザで以下の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
- ファイルが自動的にダウンロードされます（通常は
.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への手動インストール（推奨）
- Cursorを開く
-
コマンドパレットを開く
- Mac:
Cmd+Shift+P - Windows/Linux:
Ctrl+Shift+P
- Mac:
- 「Extensions: Install from VSIX...」と入力して選択
- ダウンロードしたVSIXファイルを選択
- インストール完了後、Cursorを再起動
ステップ3: インストールの確認
- 拡張機能パネル（左サイドバーの四角アイコン）を開く
- インストールされた拡張機能のリストで確認
- 機能を実際に試してみる
必要な情報の見つけ方
拡張機能IDの確認
VS Code Marketplaceのページで確認できます：
- ページURL:
https://marketplace.visualstudio.com/items?itemName={publisher}.{extension-name} - 右側の「More Info」セクションの「Unique Identifier」
最新バージョンの確認
- Marketplaceページの「Version History」タブをクリック
- 最新のバージョン番号を確認
トラブルシューティング
VSIXファイルが破損している場合
Error: End of central directory record signature not found.
解決策：
- 再度ダウンロードを試す
- ブラウザから直接ダウンロードする
- GUIからのインストールを試す（コマンドラインではなく）
ファイルが見つからないエラー
Error: ENOENT: no such file or directory
解決策：
- VSIXファイルのフルパスを指定する
- ファイルが正しくダウンロードされたか確認する
- GUIからのインストール方法を使用する
拡張機能が動作しない場合
- Cursorを完全に再起動
- 拡張機能の設定を確認
- 競合する拡張機能がないか確認
重要なポイント
コマンドラインより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で拡張機能が見つからない場合：
- VS Code MarketplaceからVSIXファイルをダウンロード
-
Cmd+Shift+P→ "Extensions: Install from VSIX..." - ダウンロードしたファイルを選択
この方法なら、ほとんどのVS Code拡張機能をCursorで使用できます。コマンドラインでエラーが発生しても、GUIからの手動インストールなら成功する可能性が高いです。
参考リンク
この記事があなたの開発環境構築の助けになれば幸いです。同じ問題で困っている方は、ぜひこの方法を試してみてください。