マーケットプレイス変更後の Cursor への VSIX 拡張機能のインストール

Microsoft は最近、VS Code Marketplace ウェブサイトから直接の VSIX ダウンロードオプションを削除しました。この変更は、拡張機能を手動でインストールする必要がある Cursor ユーザーに影響を与えます。このガイドでは、VS Code 拡張機能を Cursor にインストールするための現在の回避策を紹介します。

VSIX ファイルをインストールする理由

以下の場合に手動での VSIX インストールが必要になることがあります：

• 拡張機能が Cursor の組み込みマーケットプレイスで利用できない場合
• 特定のバージョンの拡張機能が必要な場合
• オフライン環境や企業のファイアウォール内で作業している場合
• 拡張機能がマーケットプレイスから削除された場合
• プレリリース版やベータ版をインストールしたい場合

方法 1：VS Code からダウンロード（推奨）

VSIX ファイルを入手する最も簡単な方法は、VS Code 自体を使用することです。

ステップ 1：VS Code をインストールする（まだインストールしていない場合）

code.visualstudio.com からダウンロード

ステップ 2：拡張機能をダウンロードする

1. VS Code を開く
2. 拡張機能ビューに移動（Cmd/Ctrl + Shift + X）
3. 必要な拡張機能を検索
4. 拡張機能の横にある歯車アイコン（⚙️）をクリック
5. "VSIX のダウンロード" を選択

ステップ 3：Cursor にインストールする

1. Cursor を開く
2. 拡張機能ビューに移動（Cmd/Ctrl + Shift + X）
3. ... メニュー（その他のアクション）をクリック
4. "VSIX からインストール" を選択
5. ダウンロードした .vsix ファイルを選択
6. プロンプトが表示されたら Cursor を再起動

方法 2：コマンドラインを使用する

パワーユーザー向けに、コマンドラインを使用してダウンロードおよびインストールします。

VS Code CLI でダウンロード

# 利用可能なバージョンを一覧表示
vscode --list-extensions --show-versions

# 特定の拡張機能をダウンロード
# （確実なダウンロードには上記の VS Code GUI メソッドを使用）

Cursor CLI でインストール

# ターミナルから Cursor を開く
cursor --install-extension /path/to/extension.vsix

# またはフルパスを使用
"/Applications/Cursor.app/Contents/MacOS/Cursor" --install-extension extension.vsix

方法 3：マーケットプレイス API を直接使用（上級者向け）

自動ダウンロードの場合、VS Code Marketplace API を直接使用します。

curl を使用

# 拡張機能の詳細を取得
EXTENSION="publisher.extension-name"
curl -s "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${EXTENSION%%.*}/vsextensions/${EXTENSION#*.}/latest/vspackage" \
  -H "Accept: application/json;api-version=7.2-preview.1" \
  -o extension.vsix

PowerShell を使用

$Publisher = "esbenp"
$Name = "prettier-vscode"
$Url = "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/$Publisher/vsextensions/$Name/latest/vspackage"
Invoke-WebRequest -Uri $Url -OutFile "$Name.vsix"

Python スクリプトを使用

import requests

def download_vsix(publisher, name, version="latest"):
    url = f"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{name}/{version}/vspackage"
    response = requests.get(url)
    if response.status_code == 200:
        with open(f"{name}.vsix", "wb") as f:
            f.write(response.content)
        print(f"Downloaded {name}.vsix")
    else:
        print(f"Failed: {response.status_code}")

download_vsix("esbenp", "prettier-vscode")

方法 4：Open VSX Registry から

Open VSX は、VS Code Marketplace のオープンソース代替品です。

ウェブサイトからダウンロード

1. open-vsx.org にアクセス
2. 拡張機能を検索
3. "ダウンロード" をクリック
4. Cursor に VSIX をインストール

Open VSX CLI を使用

# ovsx をインストール
npm install -g ovsx

# 拡張機能を検索
ovsx search prettier

# ダウンロード（レジストリがサポートしている場合）
# ほとんどの拡張機能はウェブサイトから手動でダウンロードする必要がある

方法 5：ソースからビルドする

オープンソースの拡張機能の場合、自分で VSIX をビルドします。

クローンとビルド

# 拡張機能リポジトリをクローン
git clone https://github.com/publisher/extension-name.git
cd extension-name

# 依存関係をインストール
npm install

# 拡張機能をビルド
npm run compile

# VSIX としてパッケージ化
npx vsce package

# .vsix ファイルは現在のディレクトリに作成される

Cursor にインストール

cursor --install-extension ./extension-name-1.0.0.vsix

人気の拡張機能とその VSIX ソース

拡張機能	パブリッシャー	代替ソース
Prettier	esbenp	Open VSX, VS Code GUI
ESLint	Microsoft	VS Code GUI only
GitLens	eamodio	Open VSX, VS Code GUI
Docker	Microsoft	VS Code GUI only
Python	Microsoft	VS Code GUI only
Live Share	Microsoft	VS Code GUI only

インストール問題のトラブルシューティング

"Corrupt ZIP" エラー

原因： 不完全なダウンロード

修正：

# VSIX ファイルを検証
unzip -t extension.vsix

# 破損している場合は再ダウンロード

"Extension Not Compatible" エラー

原因： VS Code と Cursor の間のバージョン不一致

修正：

1. ヘルプ > バージョン情報で Cursor の VS Code バージョンを確認
2. 互換性のある拡張機能バージョンをダウンロード
3. または VSIX 内の engines.vscode フィールドを変更

拡張機能が Cursor に表示されない

修正：

# インストール済みの拡張機能を一覧表示
cursor --list-extensions

# エラーを確認
cursor --verbose --install-extension extension.vsix

ベストプラクティス

バージョン管理

VSIX ファイルを管理する：

extensions/
  prettier-vscode-10.1.0.vsix
  eslint-2.4.4.vsix
  gitlens-14.4.1.vsix

自動セットアップ

新しいマシン用のセットアップスクリプトを作成：

#!/bin/bash
# setup-cursor-extensions.sh

EXTENSIONS=(
  "./extensions/prettier-vscode.vsix"
  "./extensions/eslint.vsix"
  "./extensions/gitlens.vsix"
)

for ext in "${EXTENSIONS[@]}"; do
  if [ -f "$ext" ]; then
    cursor --install-extension "$ext"
  else
    echo "Missing: $ext"
  fi
done

バックアップ戦略

拡張機能リストを定期的にエクスポート：

# インストール済みの拡張機能を保存
cursor --list-extensions > extensions.txt

# 後で再インストール
cat extensions.txt | xargs -L1 cursor --install-extension

クイックリファレンス

タスク	コマンド
VSIX をインストール	cursor --install-extension file.vsix
拡張機能を一覧表示	cursor --list-extensions
拡張機能をアンインストール	cursor --uninstall-extension publisher.name
拡張機能を無効化	cursor --disable-extension publisher.name
拡張機能を有効化	cursor --enable-extension publisher.name

関連リソース

• Managing Extensions in Cursor
• Importing VS Code Extensions
• Cursor and JetBrains Compatibility