拡張機能マーケットプレイス

Visual Studio Code に標準で含まれている機能は、ほんの始まりに過ぎません。VS Code の拡張機能を使用すると、インストール環境に言語、デバッガー、ツールを追加して、開発ワークフローをサポートできます。VS Code の豊富な拡張機能モデルにより、拡張機能の作成者は VS Code の UI に直接プラグインし、VS Code が使用しているものと同じ API を通じて機能を提供できます。この記事では、Visual Studio Code Marketplace から VS Code 拡張機能を見つけ、インストールし、管理する方法を説明します。

拡張機能を探す

拡張機能は VS Code 内から検索およびインストールできます。VS Code の側面にあるアクティビティ バーの拡張機能アイコンをクリックするか、表示: 拡張機能コマンド（⇧⌘X (Windows, Linux Ctrl+Shift+X)）を使用して、拡張機能ビューを表示します。

これにより、VS Code Marketplace で最も人気のある VS Code 拡張機能のリストが表示されます。

リスト内の各拡張機能には、簡単な説明、発行元、ダウンロード数、および5段階評価が含まれています。拡張機能項目を選択すると、詳細ページが表示され、詳細を確認できます。

拡張機能をインストールする

拡張機能をインストールするには、インストールボタンを選択します。インストールが完了すると、インストールボタンが管理歯車ボタンに変わります。

特定のバージョンの拡張機能をインストールしたい場合は、拡張機能を右クリックして別のバージョンをインストールを選択します。次に、利用可能なリストからバージョンを選択できます。

設定の同期が有効になっている場合、拡張機能などの VS Code 構成をマシン間で共有できます。拡張機能をインストールしてマシン間で同期しないようにするには、拡張機能を右クリックしてインストール (同期しない)を選択します。

拡張機能を見つけてインストールする

例えば、人気の TODO Highlight 拡張機能をインストールしてみましょう。この拡張機能は、ソースコード内の「TODO:」や「FIXME:」といったテキストを強調表示するため、未完了のセクションをすばやく見つけることができます。

拡張機能ビュー（⇧⌘X (Windows, Linux Ctrl+Shift+X)）で、検索ボックスに「todo」と入力して、タイトルやメタデータに「todo」が含まれる拡張機能にマーケットプレースの検索結果を絞り込みます。リストに TODO Highlight 拡張機能が表示されるはずです。

拡張機能は、発行元 ID と拡張機能 ID によって一意に識別されます。TODO Highlight 拡張機能を選択すると、拡張機能の詳細ページが表示され、そこで拡張機能 ID（この場合は wayou.vscode-todo-highlight）を確認できます。同様の名前の拡張機能が複数ある場合に、拡張機能 ID を知っていると役立ちます。

インストールボタンを選択すると、VS Code が Marketplace から拡張機能をダウンロードしてインストールします。インストールが完了すると、インストールボタンは管理歯車ボタンに置き換わります。

TODO Highlight 拡張機能の動作を確認するには、ソースコード ファイルを開いて「TODO:」というテキストを追加すると、テキストが強調表示されるのがわかります。

TODO Highlight 拡張機能は、コマンドパレット（⇧⌘P (Windows, Linux Ctrl+Shift+P)）から実行できる、TODO-Highlight: List highlighted annotations および TODO-Highlight: Toggle highlight というコマンドを提供します。TODO-Highlight: Toggle highlight コマンドを使用すると、強調表示をすばやく無効または有効にできます。

この拡張機能は、動作を調整するための設定も提供しており、設定エディター（⌘, (Windows, Linux Ctrl+,)）で見つけることができます。例えば、テキスト検索を大文字と小文字を区別しないようにしたい場合、Todohighlight: Is Case Sensitive 設定のチェックを外すことができます。

拡張機能が希望する機能を提供しない場合は、管理ボタンのコンテキストメニューからいつでも拡張機能をアンインストールできます。

これは、拡張機能をインストールして使用する方法の一例に過ぎません。VS Code Marketplace には、何百ものプログラミング言語やタスクをサポートする何千もの拡張機能があります。Java、Python、Go、C++ のフル機能の言語サポートから、GUID を作成したり、カラーテーマを変更したり、エディターにバーチャルペットを追加したりするシンプルな拡張機能まで、あらゆるものが揃っています。

拡張機能の詳細

拡張機能の詳細ページでは、拡張機能の README を読んだり、以下の内容を確認したりできます。

• 機能の貢献 (Feature Contributions) - 設定、コマンドとキーボードショートカット、言語文法、デバッガーなど、VS Code への拡張機能の追加機能。
• 変更履歴 (Changelog) - 利用可能な場合、拡張機能リポジトリの CHANGELOG。
• 依存関係 (Dependencies) - 拡張機能が他の拡張機能に依存しているかどうかのリスト。

拡張機能が拡張機能パックである場合、拡張機能パックセクションに、パックをインストールした際にインストールされる拡張機能が表示されます。拡張機能パックは、個別の拡張機能をバンドルして、一度に簡単にインストールできるようにしたものです。

拡張機能ビューのフィルターとコマンド

拡張機能のフィルターコンテキストメニューを使用して、拡張機能ビューを絞り込むことができます。

表示するフィルターには以下があります：

• 更新可能な古い拡張機能のリスト
• 現在有効/無効になっている拡張機能のリスト
• ワークスペースに基づいた推奨拡張機能のリスト
• 世界的に人気のある拡張機能のリスト

拡張機能リストは、インストール数、評価、名前、公開日、または更新日で、昇順または降順に並べ替えることができます。拡張機能の検索フィルターの詳細については、以下を参照してください。

... 表示およびその他のアクションボタンから、追加の拡張機能ビューコマンドを実行できます。

このコンテキストメニューを使用して、拡張機能の更新を制御したり、すべての拡張機能を有効または無効にしたり、Extension Bisect ユーティリティを使用して問題のある拡張機能の動作を切り分けたりできます。

拡張機能を検索する

拡張機能ビューの上部にある検索ボックスをクリアして、探している拡張機能、ツール、またはプログラミング言語の名前を入力できます。

例えば、「python」と入力すると、Python 言語の拡張機能リストが表示されます。

探している拡張機能の正確な識別子がわかっている場合は、@id: プレフィックスを使用できます（例: @id:vue.volar）。さらに、結果を絞り込んだり並べ替えたりするには、以下に詳述するフィルターおよび並べ替えコマンドを使用できます。

拡張機能のプレリリース版をインストールする

拡張機能の発行元は、プレリリース版の拡張機能を提供している場合があります。プレリリース版をインストールするには、インストールボタンのドロップダウンを選択し、プレリリース版をインストールを選択します。

拡張機能を管理する

VS Code では拡張機能の管理が容易です。拡張機能のインストール、無効化、更新、アンインストールは、拡張機能ビュー、コマンドパレット（コマンドには Extensions: プレフィックスが付きます）、またはコマンドラインスイッチから行えます。

インストール済み拡張機能のリスト

デフォルトでは、拡張機能ビューには現在インストールされている拡張機能と、推奨されるすべての拡張機能が表示されます。コマンドパレット（⇧⌘P (Windows, Linux Ctrl+Shift+P)）または その他のアクション (...) ドロップダウンメニュー > ビュー > インストール済み から利用できる Extensions: Focus on Installed View コマンドを使用すると、検索ボックス内のテキストをクリアし、無効化されたものを含む、インストールされているすべての拡張機能のリストを表示できます。

拡張機能をアンインストールする

拡張機能をアンインストールするには、拡張機能エントリの右側にある管理歯車ボタンを選択し、ドロップダウンメニューからアンインストールを選択します。これにより拡張機能がアンインストールされ、拡張機能ホストの再起動（拡張機能の再起動）を求められます。

拡張機能を無効にする

拡張機能を完全に削除したくない場合は、拡張機能エントリの右側にある歯車ボタンをクリックして、一時的に無効にすることができます。拡張機能は、グローバルに無効にするか、現在のワークスペースに対してのみ無効にするかを選択できます。拡張機能を無効にした後、拡張機能ホストの再起動（拡張機能の再起動）を求められます。

インストールされているすべての拡張機能をすばやく無効にしたい場合は、コマンドパレットおよびその他のアクション (...) ドロップダウンメニューに Disable All Installed Extensions コマンドがあります。

拡張機能は、再度有効にするまで、すべての VS Code セッションで無効のままになります。

拡張機能を有効にする

同様に、拡張機能を無効にしている場合（リストの Disabled セクションに表示され、Disabled とマークされます）、ドロップダウンメニューの 有効 または 有効 (ワークスペース) コマンドを使用して再度有効にできます。

その他のアクション (...) ドロップダウンメニューには、Enable All Extensions コマンドもあります。

拡張機能の自動更新

VS Code は拡張機能の更新を確認し、自動的にインストールします。更新後、拡張機能ホストの再起動（拡張機能の再起動）を求められます。

拡張機能を自分で更新したい場合は、Disable Auto Update for All Extensions コマンド、または拡張機能ビューの対応するアクションを使用して自動更新を無効にできます。 extensions.autoUpdate Open in VS Code Open in VS Code Insiders 設定を構成することもできます。自動更新を再度有効にするには、Enable Auto Update for All Extensions コマンドを使用します。

拡張機能を右クリックして 自動更新 項目を切り替えることで、個々の拡張機能の自動更新を構成することもできます。

VS Code で更新の確認自体を行いたくない場合は、 extensions.autoCheckUpdates Open in VS Code Open in VS Code Insiders 設定を false に設定できます。

拡張機能を手動で更新する

拡張機能の自動更新が無効になっている場合は、@updates フィルターを使用する Show Outdated Extensions コマンドを使用して、拡張機能の更新をすばやく確認できます。これにより、現在インストールされている拡張機能で利用可能な更新が表示されます。

古い拡張機能の 更新 ボタンを選択します。更新がインストールされ、拡張機能ホストの再起動（拡張機能の再起動）を求められます。また、Update All Extensions コマンドを使用して、すべての古い拡張機能を一度に更新することもできます。

更新の自動チェックも無効にしている場合は、Check for Extension Updates コマンドを使用して、どの拡張機能が更新可能かを確認できます。

推奨の拡張機能

@recommended フィルターを設定する Show Recommended Extensions を使用して、推奨拡張機能のリストを表示できます。拡張機能の推奨事項は、以下のいずれかになります。

• ワークスペースの推奨事項 - 現在のワークスペースの他のユーザーによって推奨されています。
• その他の推奨事項 - 最近開いたファイルに基づいて推奨されています。

プロジェクト内の他のユーザー向けに推奨事項を提供する方法については、以下のセクションを参照してください。

推奨事項を無視する

推奨事項を削除するには、拡張機能項目を選択して詳細ページを開き、管理歯車ボタンを選択してコンテキストメニューを表示します。推奨事項を無視メニュー項目を選択します。無視された推奨事項は、今後は表示されなくなります。

拡張機能の設定

VS Code の拡張機能は、構成や要件が大きく異なる場合があります。一部の拡張機能は VS Code に設定を追加し、設定エディターで変更できます。他の拡張機能には独自の構成ファイルがある場合があります。また、コンパイラ、デバッガー、コマンドラインツールなどの追加コンポーネントのインストールと設定が必要な場合もあります。拡張機能の README（拡張機能ビューの詳細ページで表示可能）を参照するか、Marketplace の拡張機能ページ（詳細ページで拡張機能名をクリック）にアクセスしてください。多くの拡張機能はオープンソースであり、Marketplace ページにリポジトリへのリンクがあります。

コマンドラインによる拡張機能管理

VS Code の自動化と構成を容易にするために、コマンドラインから拡張機能をリスト、インストール、アンインストールすることが可能です。拡張機能を指定する際は、publisher.extension という形式の完全名（例: ms-python.python）を提供してください。

例

code --extensions-dir <dir>
    Set the root path for extensions.
code --list-extensions
    List the installed extensions.
code --show-versions
    Show versions of installed extensions, when using --list-extension.
code --install-extension (<extension-id> | <extension-vsix-path>)
    Installs an extension.
code --uninstall-extension (<extension-id>)
    Uninstalls an extension.
code --enable-proposed-api (<extension-id>)
    Enables proposed API features for extensions. Can receive one or more extension IDs to enable individually.

拡張機能 ID は、詳細ページの Marketplace 情報の下で確認できます。

拡張機能ビューのフィルター

拡張機能ビューの検索ボックスは、拡張機能を見つけて管理するのに役立つフィルターをサポートしています。Show Installed Extensions や Show Recommended Extensions コマンドを使用した場合、@installed や @recommended といったフィルターを目にしたことがあるかもしれません。また、人気順や評価順で並べ替えたり、カテゴリ（例: 'Linters'）やタグ（例: 'node'）で検索したりするフィルターも利用可能です。すべてのフィルターと並べ替えコマンドの完全なリストを確認するには、拡張機能検索ボックスに @ と入力し、提案をナビゲートしてください。

拡張機能ビューのフィルターの一部を以下に示します。

• @builtin - VS Code に付属する拡張機能を表示します。タイプ別（プログラミング言語、テーマなど）にグループ化されます。
• @deprecated - 非推奨の拡張機能を表示します。
• @disabled - 無効になっているインストール済み拡張機能を表示します。
• @enabled - 有効になっているインストール済み拡張機能を表示します。拡張機能は個別に有効/無効を切り替えられます。
• @featured - おすすめの拡張機能を表示します。
• @installed - インストール済みの拡張機能を表示します。
• @popular - 人気のある拡張機能を表示します。
• @recentlyPublished - Marketplace に最近公開された拡張機能を表示します。
• @recommended - 推奨拡張機能を表示します。ワークスペース固有または一般的な用途にグループ化されます。
• @updates - インストール済みで古い拡張機能を表示します。より新しいバージョンが Marketplace で利用可能です。
• @workspaceUnsupported - このワークスペースでサポートされていない拡張機能を表示します。
• @category - 指定されたカテゴリに属する拡張機能を表示します。以下は、サポートされているカテゴリの一部です。完全なリストについては、@category と入力し、提案リストのオプションに従ってください。
  • @category:themes
  • @category:formatters
  • @category:linters
  • @category:snippets

これらのフィルターは組み合わせることもできます。例えば、@installed @category:themes を使用して、インストールされているすべてのテーマを表示します。

フィルターが指定されていない場合、拡張機能ビューには現在インストールされている拡張機能と推奨される拡張機能が表示されます。

並べ替え

@sort フィルターを使用して拡張機能を並べ替えることができます。以下の値をとることができます。

• installs - Marketplace のインストール数で降順に並べ替えます。
• name - 拡張機能名でアルファベット順に並べ替えます。
• publishedDate - 拡張機能の公開日で並べ替えます。
• rating - Marketplace の評価（1～5つ星）で降順に並べ替えます。
• updateDate - 拡張機能の最終更新日で並べ替えます。

カテゴリとタグ

拡張機能は、機能を説明する カテゴリ と タグ を設定できます。

category: および tag: を使用して、カテゴリとタグでフィルタリングできます。

サポートされているカテゴリは、[Azure, Data Science, Debuggers, Education, Extension Packs, Formatters, Keymaps, Language Packs, Linters, Machine Learning, Notebooks, Others, Programming Languages, SCM Providers, Snippets, Testing, Themes, Visualization] です。これらは、拡張機能検索ボックスの IntelliSense を通じてアクセスできます。

カテゴリ名が2単語以上の場合は、引用符で囲む必要があることに注意してください（例: category:"SCM Providers"）。

タグには任意の文字列を含めることができ、IntelliSense では提供されないため、Marketplace を確認して役立つタグを見つけてください。

VSIXからインストールする

.vsix ファイルにパッケージ化された VS Code 拡張機能を手動でインストールできます。拡張機能ビューのコマンドドロップダウンにある Install from VSIX コマンド、またはコマンドパレットの Extensions: Install from VSIX コマンドを使用して、.vsix ファイルを指定します。

また、.vsix ファイルへのパスを指定して、VS Code の --install-extension コマンドラインスイッチを使用してインストールすることもできます。

code --install-extension myextension.vsix

複数の拡張機能を一度にインストールするには、コマンドラインで --install-extension を複数回指定できます。

拡張機能のパッケージ化と公開の詳細については、Extension API の拡張機能の公開記事を参照してください。

ワークスペースで推奨される拡張機能

適切な一連の拡張機能を使用すると、特定のワークスペースやプログラミング言語での作業がより生産的になり、チームや同僚とこのリストを共有したいことがよくあります。ワークスペースの推奨拡張機能リストは、Extensions: Configure Recommended Extensions (Workspace Folder) コマンドで作成できます。

単一フォルダーのワークスペースでは、このコマンドはワークスペースの .vscode フォルダー内に extensions.json ファイルを作成し、そこに拡張機能識別子のリスト（{publisherName}.{extensionName}）を追加できます。

マルチルートワークスペースでは、このコマンドは .code-workspace ファイルを開き、extensions.recommendations の下に拡張機能をリストできます。Extensions: Configure Recommended Extensions (Workspace Folder) コマンドを使用することで、マルチルートワークスペース内の個々のフォルダーに拡張機能の推奨事項を追加することもできます。

extensions.json の例は以下の通りです：

{
  "recommendations": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]
}

これは、リンター拡張機能とコードフォーマッター拡張機能を推奨しています。

拡張機能は、発行元識別子と拡張機能識別子 publisher.extension を使用して識別されます。名前は拡張機能の詳細ページで確認できます。VS Code は、これらのファイル内でインストール済みの拡張機能のオートコンプリートを提供します。

.

VS Code は、ワークスペースを初めて開く際に、ユーザーに推奨拡張機能のインストールを促します。ユーザーは Extensions: Show Recommended Extensions コマンドでリストを確認することもできます。

次のステップ

興味があるかもしれないトピックをいくつか紹介します...

• Extension API - VS Code 拡張機能 API について学習を始めましょう。
• Your First Extension - シンプルな Hello World 拡張機能を作成してみましょう。
• Marketplace への公開 - 独自の拡張機能を VS Code Marketplace に公開しましょう。

よくある質問

拡張機能はどこにインストールされますか？

拡張機能はユーザーごとの拡張機能フォルダーにインストールされます。プラットフォームに応じて、場所は以下のフォルダーになります。

• Windows %USERPROFILE%\.vscode\extensions
• macOS ~/.vscode/extensions
• Linux ~/.vscode/extensions

--extensions-dir <dir> コマンドラインオプションを指定して VS Code を起動することで、場所を変更できます。

あるいは、VSCODE_EXTENSIONS 環境変数を設定して、拡張機能のインストール先を指定することもできます。これは、ユーザーのマシン上で拡張機能のインストール場所を一元管理したい企業環境で役立ちます。

拡張機能をインストールしようとすると、connect ETIMEDOUT エラーが発生します

インターネットにアクセスするためにマシンがプロキシ サーバーを経由している場合、このエラーが発生することがあります。詳細については、セットアップトピックの「プロキシ サーバーのサポート」セクションを参照してください。

Marketplace から直接拡張機能をダウンロードできますか？

一部のユーザーは、Marketplace から一度拡張機能をダウンロードし、それをローカル共有から複数の VS Code インスタンスにインストールすることを好みます。これは、接続に懸念がある場合や、開発チームが固定された一連の拡張機能を使用したい場合に役立ちます。

拡張機能をダウンロードするには、拡張機能ビューで検索し、結果から拡張機能を右クリックして Download VSIX または Download Specific Version VSIX を選択します。

VS Code が拡張機能の推奨事項を提供しないようにできますか？

はい、VS Code が拡張機能ビューや通知を通じて推奨事項を表示しないようにしたい場合は、以下の設定を変更できます。

• extensions.showRecommendationsOnlyOnDemand Open in VS Code Open in VS Code Insiders - true に設定すると、RECOMMENDED セクションが削除されます。
• extensions.ignoreRecommendations Open in VS Code Open in VS Code Insiders - true に設定すると、拡張機能の推奨通知が消音されます。

推奨事項を確認したい場合は、Show Recommended Extensions コマンドをいつでも利用できます。

Marketplace の拡張機能を信頼できますか？

Visual Studio Marketplace は、悪意のある拡張機能から保護するためにいくつかの対策を講じており、インストール前に拡張機能が信頼できるかどうかを判断するためのさまざまな手順を実行することもできます。

VS Code 1.97 リリース以降、サードパーティの発行元から拡張機能を初めてインストールする際、VS Code は拡張機能の発行元を信頼することを確認するダイアログを表示します。

拡張機能の実行時のセキュリティの詳細をご覧ください。

組織内で内部的に拡張機能をホストできますか？

はい、「拡張機能のためのプライベートマーケットプレース」を参照してください。

拡張機能の署名を VS Code で検証できません

Visual Studio Marketplace は、拡張機能が公開される際にすべて署名します。VS Code は、拡張機能をインストールする際にこの署名を検証し、拡張機能パッケージの整合性とソースを確認します。

パッケージ整合性の問題

パッケージ整合性の問題については、Visual Studio Marketplace チームに連絡して問題を報告することをお勧めします。必ず拡張機能 ID を含めてください。以下のリストは、パッケージ整合性の問題に関連するエラーコードを提供します。

PackageIntegrityCheckFailed
SignatureIsInvalid
SignatureManifestIsInvalid
SignatureIntegrityCheckFailed
EntryIsMissing
EntryIsTampered
Untrusted
CertificateRevoked
SignatureIsNotValid
SignatureArchiveHasTooManyEntries
NotSigned

その他の問題

サポートされていない環境や不明な理由など、その他の問題については、必要な情報をすべて提供し、共有ログを含めて VS Code に問題を報告することをお勧めします：⇧⌘P (Windows, Linux Ctrl+Shift+P) > ビューを開く... > 共有 (Shared)。

リモートウィンドウに接続しても拡張機能が同期されません

設定の同期を使用すると、設定、キーボードショートカット、インストールされている拡張機能などの Visual Studio Code 構成をマシン間で共有できるため、常に好みのセットアップで作業できます。

VS Code は、SSH、開発コンテナー (devcontainer)、または WSL に接続している場合などのリモートウィンドウとの間で拡張機能を同期しません。

組織内の特定の拡張機能を許可またはブロックできますか？

extensions.allowed アプリケーション設定を構成することで、組織内にインストールできる拡張機能を制御できます。設定が構成されていない場合は、すべての拡張機能が許可されます。設定が構成されている場合、リストにないすべての拡張機能はインストールがブロックされます。

許可された拡張機能の構成に関する詳細を確認してください。