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

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」と入力して、Marketplace の提供をタイトルまたはメタデータに「todo」を含む拡張機能に絞り込みます。リストにTODO Highlight拡張機能が表示されるはずです。

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

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

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

TODO Highlight 拡張機能は、コマンドパレット (⇧⌘P (Windows, Linux Ctrl+Shift+P)) で見つけることができるTODO-Highlight: 強調表示された注釈を一覧表示とTODO-Highlight: 強調表示の切り替えのコマンドを提供します。TODO-Highlight: 強調表示の切り替えコマンドを使用すると、強調表示をすばやく無効または有効にできます。

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

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

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

拡張機能の詳細

拡張機能の詳細ページでは、拡張機能の README を読み、拡張機能の次の情報を確認できます。

• 機能の提供 - 設定、コマンド、キーボードショートカット、言語文法、デバッガーなど、VS Code への拡張機能の追加。
• 変更ログ - 拡張機能リポジトリの CHANGELOG (利用可能な場合)。
• 依存関係 - 拡張機能が他の拡張機能に依存しているかどうかを一覧表示します。

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

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

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

表示するフィルターは次のとおりです。

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

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

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

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

拡張機能の検索

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

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

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

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

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

拡張機能を管理する

VS Code を使用すると、拡張機能を簡単に管理できます。拡張機能ビュー、コマンドパレット (コマンドには拡張機能:プレフィックスが付いています)、またはコマンドラインスイッチを介して、拡張機能のインストール、無効化、更新、およびアンインストールを行うことができます。

インストールされている拡張機能を一覧表示

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

拡張機能のアンインストール

拡張機能をアンインストールするには、拡張機能エントリの右側にある管理ギアボタンを選択し、ドロップダウンメニューからアンインストールを選択します。これにより、拡張機能がアンインストールされ、拡張機能ホストの再起動 (拡張機能の再起動) を促すメッセージが表示されます。

拡張機能の無効化

拡張機能を完全に削除したくない場合は、拡張機能エントリの右側にあるギアボタンをクリックして、一時的に拡張機能を無効にすることができます。拡張機能はグローバルに、または現在のワークスペースでのみ無効にできます。拡張機能を無効にした後、拡張機能ホストの再起動 (拡張機能の再起動) を促すメッセージが表示されます。

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

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

拡張機能の有効化

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

その他のアクション (...) ドロップダウンメニューには、すべての拡張機能を有効にするコマンドもあります。

拡張機能の自動更新

VS Code は拡張機能の更新を確認し、自動的にインストールします。更新後、拡張機能ホストの再起動 (拡張機能の再起動) を促すメッセージが表示されます。

拡張機能を手動で更新したい場合は、すべての拡張機能の自動更新を無効にするコマンド、または拡張機能ビューの対応するアクションで自動更新を無効にできます。extensions.autoUpdate 設定を構成することもできます。自動更新を再度有効にするには、すべての拡張機能の自動更新を有効にするコマンドを使用します。

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

VS Code が更新を確認しないようにしたい場合は、extensions.autoCheckUpdates 設定を false に設定できます。

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

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

古い拡張機能の更新ボタンを選択します。更新がインストールされ、拡張機能ホストの再起動 (拡張機能の再起動) を促すメッセージが表示されます。すべての拡張機能を更新コマンドを使用して、すべての古い拡張機能を一度に更新することもできます。

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

推奨される拡張機能

@recommended フィルターを設定する推奨拡張機能を表示を使用して、推奨される拡張機能のリストを確認できます。拡張機能の推奨事項は次のいずれかです。

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

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

推奨事項を無視する

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

拡張機能の構成

VS Code 拡張機能は、非常に異なる構成と要件を持つ場合があります。一部の拡張機能は VS Code に設定を提供し、これらは設定エディターで変更できます。他の拡張機能は独自の構成ファイルを持つ場合があります。拡張機能は、コンパイラ、デバッガー、コマンドラインツールなどの追加コンポーネントのインストールと設定も必要とする場合があります。拡張機能の README (拡張機能ビューの詳細ページに表示) を参照するか、VS Code 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 情報の下で確認できます。

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

拡張機能ビューの検索ボックスは、拡張機能を見つけて管理するのに役立つフィルターをサポートしています。インストール済み拡張機能を表示および推奨拡張機能を表示コマンドを使用したことがある場合は、@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 を介してアクセスできます。

カテゴリ名が複数の単語で構成されている場合 (例: category:"SCM Providers")、引用符で囲む必要があることに注意してください。

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

VSIX からインストール

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

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

code --install-extension myextension.vsix

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

拡張機能のパッケージ化と公開についてさらに詳しく知りたい場合は、拡張機能 API の「拡張機能の公開」の記事を参照してください。

ワークスペースの推奨拡張機能

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

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

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

extensions.json の例は次のとおりです。

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

これは、リンター拡張機能とコードフォーマッター拡張機能を推奨するものです。

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

.

VS Code は、ワークスペースが初めて開かれたときに、推奨される拡張機能をインストールするようユーザーに促します。ユーザーは、**拡張機能: 推奨拡張機能を表示**コマンドを使用してリストを確認することもできます。

次のステップ

興味深いトピックをいくつか紹介します...

• 拡張機能 API - VS Code 拡張機能 API について学び始めましょう。
• 最初の拡張機能 - シンプルな 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 インスタンスにインストールすることを好みます。これは、接続の問題がある場合や、開発チームが固定された拡張機能セットを使用したい場合に便利です。

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

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

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

• extensions.showRecommendationsOnlyOnDemand - RECOMMENDED セクションを削除するには true に設定します。
• extensions.ignoreRecommendations - 拡張機能の推奨通知を抑制するには true に設定します。

推奨事項を表示したい場合は、推奨拡張機能を表示コマンドは常に利用可能です。

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) > ビューを開く... > 共有。

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

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

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

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

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

許可される拡張機能の構成に関する詳細情報を参照してください。