IT 注目度 69

Open VSX環境での「拡張機能バージョン不適合エラー」の根本的な対処法

※本記事の要約および解説はAIが自動生成しており、誤りが含まれる可能性があります。事実確認は元ニュースをご参照ください。

本記事は、Google Antigravityなど、VS CodeをベースにフォークされたIDE（統合開発環境）を利用する際に発生する「拡張機能のバージョン不適合エラー」の具体的な解決策を解説しています。このエラーは、IDE独自のバージョン表記（例: 1.23.2）と、Open VSXの拡張機能が要求する本家VS Codeのバージョン基準（例: ^1.85.0）との間でバージョン判定のバグ（仕様のズレ）が生じるために発生します。解決の核心は、IDEのコア設定ファイルである`product.json`を直接編集し、内部のバージョン差異を解消することです。

具体的な手順として、まず使用環境（Ubuntu/Linux、Windows、Mac）に応じたパスから`product.json`を探し出します。次に、管理者権限のテキストエディタでファイルを開き、上部にある`"ideVersion"`の記述を、ファイルの最下部に記載されている実際のベースとなった本家VS Codeのバージョン（例: "1.102.0"）に合わせて書き換えます。この変更を保存し、IDEを完全に再起動することで、バージョン整合性が保たれ、拡張機能がエラーなくインストール・有効化できるようになります。

さらに、バージョン書き換え後に発生しがちな「新しい更新がある」というポップアップ通知を防ぐため、ユーザー設定ファイル`settings.json`に以下の3行を追加する追加の推奨設定も推奨されています。

```json

{

"update.mode": "none",

"extensions.autoUpdate": false,

"extensions.closeExtensionUpdateOnIncompatible": true

}

```

この2ステップ（`product.json`の修正と`settings.json`の調整）を行うことで、Open VSX環境でも本家VS Codeと遜色ない快適な拡張機能利用が可能になると結論づけています。

背景

VS Codeのような人気エディタがフォークされ、様々な派生IDE（例：Antigravity）が生まれる過程で、各IDEが独自のバージョン管理システムを持つことがあります。この記事で指摘されているエラーは、派生IDEが親元である本家VS Codeのバージョン基準を正確に反映できていない「バージョン判定の仕様のズレ」が原因です。

重要用語解説

IDE: Integrated Development Environment（統合開発環境）の略。コードの記述、コンパイル、デバッグなど、開発に必要な機能が一箇所にまとまったソフトウェアのこと。
product.json: IDEのコア設定ファイルの一つ。このファイルには、そのIDEがどのバージョンのベースソフトウェアに基づいているかを示すバージョン情報（ideVersion）が記述されている。
Open VSX: VS Codeの拡張機能エコシステムを指す用語。本記事では、この環境で拡張機能を導入する際にバージョン不適合エラーが発生する状況を指している。

今後の影響

この知識は、VS Codeの派生IDEを利用する開発者にとって非常に実用的なトラブルシューティング情報です。バージョン不適合エラーという技術的な障壁を、設定ファイルの直接編集という具体的な手順で解消できるため、開発効率の維持に大きく貢献します。

Information Sources:

https://zenn.dev/sjm3610/articles/e7463a6808e01e