Visual Studio Code（VSCode）の拡張機能は、通常は拡張機能画面からVisual Studio Marketplaceを利用してインストールします。
ただし、インターネットへ接続できない環境で利用する場合や、特定バージョンの拡張機能を固定して使いたい場合、社内で配布された拡張機能を導入したい場合などには、.vsix ファイルを利用して手動インストールできます。
VSCodeでは、画面上からVSIXファイルを指定する方法と、code コマンドを利用する方法が用意されています。
VSCodeの拡張機能を手動インストールする主な方法
VSCodeの拡張機能を手動インストールする場合、主にVSIXファイルを使用します。
VSIXとは、VSCodeの拡張機能を配布するために使用されるパッケージファイルです。
たとえば、次のようなファイルがあります。
sample-extension-1.0.0.vsixこのVSIXファイルをVSCodeへ読み込むことで、Marketplaceから直接インストールしなくても拡張機能を導入できます。
Extensions画面からVSIXをインストールする
もっとも分かりやすい方法は、VSCodeのExtensions画面からVSIXファイルを選択する方法です。
まず、VSCodeを起動し、画面左側にある「Extensions（拡張機能）」アイコンをクリックします。
WindowsやLinuxでは、次のショートカットでもExtensions画面を開けます。
Ctrl + Shift + XmacOSでは次のショートカットです。
Shift + Command + XExtensions画面を開いたら、画面上部にある「…」などのメニューを開きます。
続いて、次の項目を選択します。
Install from VSIX...日本語版では、バージョンによって「VSIXからのインストール」などと表示される場合があります。
ファイル選択画面が表示されたら、あらかじめ用意しておいた .vsix ファイルを選択します。
たとえば、次のようなファイルです。
my-extension-1.0.0.vsixファイルを選択すると、VSCodeへ拡張機能がインストールされます。
コマンドパレットからVSIXをインストールする
VSIXファイルは、コマンドパレットからインストールすることもできます。
WindowsやLinuxでは、次のショートカットでコマンドパレットを開きます。
Ctrl + Shift + PmacOSでは次のショートカットです。
Command + Shift + Pコマンドパレットを開いたら、次のコマンドを検索します。
Extensions: Install from VSIXコマンドを選択するとファイル選択画面が表示されるので、インストールしたいVSIXファイルを指定します。
コマンドラインからVSIXをインストールする方法
VSCodeでは、CLIを利用してVSIXファイルをインストールすることもできます。
コマンド操作に慣れている場合や、複数のPCへ同じ拡張機能を導入したい場合には便利です。
code –install-extensionを利用する
基本的なコマンドは次のとおりです。
code --install-extension my-extension.vsixたとえば、現在のディレクトリに、
sample-extension-1.0.0.vsixというファイルがある場合は、次のように実行します。
code --install-extension sample-extension-1.0.0.vsixこれでVSIXファイルから拡張機能をインストールできます。
VSIXファイルのフルパスを指定する
VSIXファイルが別のフォルダにある場合は、ファイルパスを指定できます。
Windowsでは、たとえば次のようになります。
code --install-extension "C:\Users\User\Downloads\sample-extension-1.0.0.vsix"macOSやLinuxの場合は、次のように指定できます。
code --install-extension ~/Downloads/sample-extension-1.0.0.vsixファイルパスに空白が含まれている場合は、ダブルクォーテーションで囲んでおくと安全です。
複数のVSIXをインストールする
--install-extension は複数回指定できます。
たとえば、複数の拡張機能をまとめてインストールする場合は、次のように実行できます。
code --install-extension extension-a.vsix --install-extension extension-b.vsix複数の開発環境へ同じ拡張機能を導入するときなどに便利です。
拡張機能IDからインストールする方法
VSIXファイルを用意しなくても、拡張機能IDを指定してインストールすることもできます。
VSCodeの拡張機能IDは、一般的に次の形式になっています。
publisher.extensionたとえばMicrosoftのPython拡張機能であれば、次のようにインストールできます。
code --install-extension ms-python.pythonただし、この方法ではMarketplaceへアクセスする必要があります。
そのため、完全なオフライン環境ではVSIXファイルを用意する必要があります。
特定バージョンを指定してインストールする
Marketplace上の拡張機能であれば、CLIから特定バージョンを指定することもできます。
基本的な形式は次のとおりです。
code --install-extension publisher.extension@バージョンたとえば次のように指定します。
code --install-extension example.extension@1.2.3開発環境によって拡張機能のバージョンを固定したい場合に便利です。
VSIXファイルを入手する方法
手動インストールを行うには、事前にVSIXファイルを用意する必要があります。
VSCodeからVSIXをダウンロードする
VSCodeでは、Extensions画面から拡張機能のVSIXを取得できる場合があります。
対象の拡張機能を右クリックすると、次のような項目を利用できます。
Download VSIXまたは、
Download Specific Version VSIX「Download VSIX」を利用すると現在の対象バージョンを取得でき、「Download Specific Version VSIX」を利用すると特定バージョンのVSIXを選択して取得できます。
特定バージョンを固定して運用したい場合や、オフライン環境へ拡張機能を持ち込みたい場合に便利です。
公式GitHubリポジトリなどから入手する
一部の拡張機能では、開発元の公式GitHubリポジトリのReleasesページなどからVSIXファイルが配布されている場合があります。
ただし、GitHub上にあるVSIXファイルだからといって必ず安全とは限りません。
利用するときは、必ずその拡張機能の公式リポジトリであることを確認することが重要です。
オフライン環境へ拡張機能をインストールする方法
VSIXを利用すれば、インターネットへ接続できないPCにも拡張機能を導入できます。
基本的な流れは次のとおりです。
インターネット接続可能なPC
↓
VSIXファイルを取得
↓
USBメモリや社内ストレージなどへ保存
↓
オフラインPCへ移動
↓
Install from VSIXでインストールオフラインPCでは、VSCodeのExtensions画面から「Install from VSIX…」を選択します。
または、CLIが利用できる場合は次のようにインストールできます。
code --install-extension sample-extension.vsix企業のPCでは、管理者によってインストール可能な拡張機能が制限されている場合があります。
そのため、VSIXファイルを用意しても、組織の管理ポリシーによってインストールできないケースがあります。
インストール済みの拡張機能を確認する方法
手動インストールした拡張機能も、通常の拡張機能と同じようにExtensions画面から確認できます。
CLIから一覧を確認することも可能です。
拡張機能IDの一覧を表示する
次のコマンドを実行します。
code --list-extensionsインストールされている拡張機能IDが一覧表示されます。
拡張機能のバージョンも確認する
バージョンまで表示したい場合は、次のコマンドを利用します。
code --list-extensions --show-versionsたとえば、次のように表示されます。
ms-python.python@2026.x.x
example.sample-extension@1.0.0手動インストールした拡張機能のバージョン確認にも利用できます。
手動インストールした拡張機能をアンインストールする方法
VSIXからインストールした拡張機能も、通常の拡張機能と同様にアンインストールできます。
Extensions画面から対象の拡張機能を選択し、「Uninstall」を実行します。
CLIから削除する場合は、次のコマンドを使用します。
code --uninstall-extension publisher.extensionたとえば次のように実行します。
code --uninstall-extension example.sample-extensionVSIXからインストールした拡張機能の自動更新
VSIXから拡張機能をインストールすると、その拡張機能の自動更新はデフォルトで無効になります。
これは、特定のバージョンを意図してインストールしたにもかかわらず、自動更新によって別のバージョンへ変更されることを防ぐためです。
バージョン管理が必要になる場合がある
VSIXを利用して拡張機能を固定運用する場合は、自分で新しいバージョンを確認する必要があります。
企業などでVSIXを配布している場合は、
利用中のバージョンを管理
↓
新しいバージョンを確認
↓
必要に応じてVSIXを更新
↓
利用者へ再配布といった運用が必要になる場合があります。
セキュリティ修正を含むアップデートが公開されることもあるため、古いバージョンを長期間放置しないことが重要です。
VSIXをインストールできない場合の原因と対処法
VSIXファイルを指定しても、正常にインストールできない場合があります。
主な原因を確認しておきましょう。
VSCodeのバージョンが対応していない
拡張機能には、対応するVSCodeのバージョンが設定されている場合があります。
新しい拡張機能が新しいVSCode APIを必要としている場合、古いVSCodeではインストールできなかったり、正常に動作しなかったりする可能性があります。
この場合は、VSCodeを最新版へ更新するか、対応している古いバージョンの拡張機能を利用します。
VSIXファイルが破損している
ダウンロード途中で通信が切断された場合などには、VSIXファイルが正常に保存されていない可能性があります。
この場合は、信頼できる公式の配布元からVSIXを再取得します。
拡張機能の署名確認に失敗している
Visual Studio Marketplaceで配布されている拡張機能では、インストール時に署名確認が行われます。
署名を正常に確認できない場合、拡張機能をインストールできないことがあります。
VSCodeには署名確認を無効にする設定もありますが、エラー原因を確認せず安易に無効化するのは避けた方がよいでしょう。
まずは、VSIXファイルの入手元やファイルの破損、ネットワーク環境などを確認することが重要です。
codeコマンドが利用できない場合
CLIからインストールしようとしたときに、
code: command not foundまたは、
'code' is not recognizedなどと表示される場合があります。
これは、code コマンドがPATHから利用できない状態になっている可能性があります。
GUIからインストールする
code コマンドが使えなくても、VSCodeの画面から、
Extensions
↓
…
↓
Install from VSIX...を選択すれば手動インストールできます。
コマンドラインを使用する必要がない場合は、この方法が簡単です。
VS Code Insidersへインストールする場合
通常版のVSCodeでは、次のコマンドを使用します。
code --install-extension extension.vsix一方、VS Code Insidersでは、次のコマンドを利用できます。
code-insiders --install-extension extension.vsix通常版とInsiders版を併用している場合は、インストール先を間違えないよう注意が必要です。
Profilesを利用している場合
VSCodeではProfiles機能を利用し、用途ごとに設定や拡張機能を分けることができます。
CLIから特定のプロファイルへ拡張機能をインストールする場合は、--profile を利用できます。
たとえば次のように実行します。
code --install-extension ms-python.python --profile "Python"複数のプロファイルを使い分けている場合は、どのプロファイルにインストールするのか確認しておくとよいでしょう。
Remote SSH・WSL・Dev Containersを使っている場合
VSCodeでは、Remote SSH、WSL、Dev Containers、GitHub Codespacesなどのリモート開発環境を利用できます。
これらを使用している場合、拡張機能がローカル側で動作するのか、リモート側で動作するのかを意識する必要があります。
ローカルとリモートではインストール先が異なることがある
たとえば、SSH接続先のLinuxサーバー上で動作する拡張機能の場合、ローカルPCへインストールするだけでは利用できない場合があります。
リモート環境へ接続したVSCodeウィンドウから「Install from VSIX…」を実行することで、その環境へ拡張機能を導入できます。
そのため、リモート開発時には、
ローカル環境で必要な拡張機能なのかそれとも、
リモート環境で必要な拡張機能なのかを確認することが重要です。
拡張機能の保存場所
標準的なVSCode環境では、ユーザー単位の拡張機能は専用フォルダへ保存されます。
Windowsでは通常、次の場所です。
%USERPROFILE%\.vscode\extensionsmacOSやLinuxでは通常、次の場所です。
~/.vscode/extensionsただし、--extensions-dir を利用して保存先を変更している場合や、Portable Modeなどを利用している場合は保存場所が異なることがあります。
拡張機能フォルダへ直接コピーする方法
拡張機能フォルダへファイルを直接配置する方法も考えられますが、一般的な手動インストールでは、
Install from VSIX...または、
code --install-extensionを利用する方が分かりやすく確実です。
VSCodeが用意している標準的なインストール方法を優先するとよいでしょう。
VSIXを手動インストールするときのセキュリティ対策
VSIXはMarketplace以外からも入手できるため、配布元の確認が非常に重要です。
VSCodeの拡張機能は、ファイルへのアクセスやネットワーク通信、外部プロセスの実行など、幅広い処理を行える場合があります。
そのため、出所が不明なVSIXを安易にインストールするのは避けましょう。
信頼できる配布元から入手する
VSIXを入手するときは、基本的に次のような場所を利用します。
Visual Studio Marketplace
拡張機能開発元の公式サイト
公式GitHubリポジトリ
所属組織から正式に配布されたファイル第三者が再配布しているVSIXや、出所を確認できないファイルは避けるのが安全です。
Publisherも確認する
VSCodeでは、第三者Publisherの拡張機能を初めてインストールするときに、Publisherを信頼するか確認されることがあります。
拡張機能名だけでなく、
Publisher名
公式サイト
GitHubリポジトリ
インストール数
説明内容なども確認するとよいでしょう。
CLIからインストールしたからといって、そのPublisherが自動的にTrusted Publisherになるわけではない点にも注意が必要です。
VSCodeの拡張機能を手動インストールする方法のまとめ
VSCodeの拡張機能を手動インストールする場合は、基本的に .vsix ファイルを使用します。
もっとも簡単なのは、VSCodeのExtensions画面から、
Extensions
↓
…
↓
Install from VSIX...
↓
VSIXファイルを選択という手順でインストールする方法です。
CLIを利用する場合は、次のコマンドを使用できます。
code --install-extension my-extension.vsixインストール済みの拡張機能とバージョンを確認する場合は、次のコマンドが便利です。
code --list-extensions --show-versionsVSIXによる手動インストールは、オフライン環境、社内ネットワーク、特定バージョンを固定したい場合、開発中の拡張機能をテストしたい場合などに便利です。
一方で、VSIXからインストールした拡張機能は自動更新がデフォルトで無効になるため、バージョン管理やセキュリティ更新を自分で確認する必要があります。
また、Marketplace外からVSIXを入手する場合は、拡張機能の安全性を慎重に確認し、公式サイトや公式リポジトリなど信頼できる配布元を利用することが重要です。
以上、VSCodeの拡張機能を手動インストールする方法についてでした。
最後までお読みいただき、ありがとうございました。
