擴充套件市場

Visual Studio Code 開箱即用的功能僅僅是個開始。VS Code 擴充套件可以讓你在安裝中新增語言、偵錯程式和工具，以支援你的開發工作流程。VS Code 豐富的可擴充套件性模型允許擴充套件作者直接接入 VS Code 使用者介面，並透過 VS Code 使用的相同 API 來貢獻功能。本文將介紹如何從 Visual Studio Code 擴充套件市場 中查詢、安裝和管理 VS Code 擴充套件。

瀏覽擴充套件

你可以在 VS Code 內部瀏覽和安裝擴充套件。點選 VS Code 側邊欄的 活動欄 中的擴充套件圖示，或使用 檢視：擴充套件 命令 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 來開啟擴充套件檢視。

這會顯示 VS Code 擴充套件市場 上最受歡迎的 VS Code 擴充套件列表。

列表中的每個擴充套件都包含簡要描述、釋出者、下載次數和五星評級。你可以選擇某個擴充套件以顯示其詳情頁面，瞭解更多資訊。

安裝擴充套件

要安裝擴充套件，請選擇 安裝 按鈕。安裝完成後，安裝 按鈕會變為 管理 齒輪按鈕。

如果你想安裝特定版本的擴充套件，可以右鍵單擊該擴充套件並選擇 安裝另一版本。然後你可以從可用列表中選擇一個版本。

當設定同步啟用時，你可以在多臺裝置間共享你的 VS Code 配置，例如擴充套件。如果想安裝一個擴充套件但不跨裝置同步，可以右鍵單擊該擴充套件並選擇 安裝（不同步）。

查詢並安裝擴充套件

例如，我們來安裝流行的 TODO Highlight 擴充套件。這個擴充套件可以高亮你原始碼中的 'TODO:' 和 'FIXME:' 等文字，以便你快速找到未完成的部分。

在擴充套件檢視 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 中，在搜尋框裡輸入 'todo'，將擴充套件市場的結果篩選為標題或元資料中包含 'todo' 的擴充套件。你應該能在列表中看到 TODO Highlight 擴充套件。

每個擴充套件都由其釋出者和擴充套件 ID 唯一標識。如果你選擇 TODO Highlight 擴充套件，你將看到擴充套件詳情頁面，在那裡你可以找到擴充套件 ID，在本例中是 wayou.vscode-todo-highlight。當有多個名稱相似的擴充套件時，知道擴充套件 ID 會很有幫助。

選擇 安裝 按鈕，VS Code 將從擴充套件市場下載並安裝該擴充套件。安裝完成後，安裝 按鈕將被替換為 管理 齒輪按鈕。

要檢視 TODO Highlight 擴充套件的效果，開啟任意原始碼檔案並新增文字 'TODO:'，你就會看到文字被高亮顯示。

TODO Highlight 擴充套件貢獻了 TODO-Highlight: List highlighted annotations 和 TODO-Highlight: Toggle highlight 命令，你可以在命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 中找到它們。TODO-Highlight: Toggle highlight 命令可以讓你快速停用或啟用高亮功能。

該擴充套件還提供了用於調整其行為的設定，你可以在設定編輯器 (⌘, (Windows、Linux Ctrl+,)) 中找到它們。例如，你可能希望文字搜尋不區分大小寫，這時可以取消勾選 Todohighlight: Is Case Sensitive 設定。

如果一個擴充套件沒有提供你想要的功能，你隨時可以從 管理 按鈕的上下文選單中 解除安裝 該擴充套件。

這只是如何安裝和使用擴充套件的一個例子。VS Code 擴充套件市場擁有數千個擴充套件，支援數百種程式語言和任務。從功能齊全的 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 擴充套件市場 上的擴充套件頁面（在詳情頁面點選副檔名稱）。許多擴充套件是開源的，並在其市場頁面上提供了其程式碼倉庫的連結。

命令列擴充套件管理

為了更方便地自動化和配置 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。

擴充套件檢視篩選器

擴充套件檢視的搜尋框支援篩選器，以幫助你查詢和管理擴充套件。如果你使用過 顯示已安裝的擴充套件 和 顯示推薦的擴充套件 命令，你可能已經見過像 @installed 和 @recommended 這樣的篩選器。此外，還有可用的篩選器讓你按流行度或評分排序，並按類別（例如“Linters”）和標籤（例如“node”）搜尋。你可以在擴充套件搜尋框中輸入 @ 並瀏覽建議列表，以檢視所有篩選器和排序命令的完整列表。

以下是一些擴充套件檢視篩選器：

• @builtin - 顯示 VS Code 自帶的擴充套件。按型別（程式語言、主題等）分組。
• @deprecated - 顯示已棄用的擴充套件。
• @disabled - 顯示已停用的已安裝擴充套件。
• @enabled - 顯示已啟用的已安裝擴充套件。擴充套件可以單獨啟用/停用。
• @featured - 顯示精選擴充套件。
• @installed - 顯示已安裝的擴充套件。
• @popular - 顯示熱門擴充套件。
• @recentlyPublished - 顯示最近在擴充套件市場釋出的擴充套件。
• @recommended - 顯示推薦的擴充套件。分為工作區特定或通用推薦。
• @updates - 顯示過時的已安裝擴充套件。擴充套件市場有新版本可用。
• @workspaceUnsupported - 顯示此工作區不支援的擴充套件。
• @category - 顯示屬於指定類別的擴充套件。以下是一些支援的類別。要檢視完整列表，請鍵入 @category 並遵循建議列表中的選項。
  • @category:themes
  • @category:formatters
  • @category:linters
  • @category:snippets

這些篩選器也可以組合使用。例如：使用 @installed @category:themes 檢視所有已安裝的主題。

如果未提供篩選器，擴充套件檢視將顯示當前已安裝和推薦的擴充套件。

排序

你可以使用 @sort 篩選器對擴充套件進行排序，該篩選器可以接受以下值：

• installs - 按擴充套件市場安裝次數降序排序。
• name - 按副檔名稱字母順序排序。
• publishedDate - 按擴充套件釋出日期排序。
• rating - 按擴充套件市場評級（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]。它們可以透過擴充套件搜尋框中的智慧感知來訪問。

請注意，如果類別名稱包含多個單詞，你必須用引號將其括起來（例如，category:"SCM Providers"）。

標籤可以包含任何字串，並且不由智慧感知提供，因此請檢視擴充套件市場以查詢有用的標籤。

從 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"]
}

它推薦了一個 linter 擴充套件和一個程式碼格式化擴充套件。

擴充套件使用其釋出者識別符號和擴充套件識別符號 publisher.extension 來識別。你可以在擴充套件的詳情頁面上看到這個名稱。VS Code 會在這些檔案中為已安裝的擴充套件提供自動補全功能。

.

當工作區首次開啟時，VS Code 會提示使用者安裝推薦的擴充套件。使用者也可以使用 擴充套件：顯示推薦的擴充套件 命令來檢視列表。

後續步驟

以下是一些你可能感興趣的主題...

• 擴充套件 API - 開始學習 VS Code 擴充套件 API。
• 你的第一個擴充套件 - 嘗試建立一個簡單的 Hello World 擴充套件。
• 釋出到擴充套件市場 - 將你自己的擴充套件釋出到 VS Code 擴充套件市場。

常見問題

擴充套件安裝在哪裡？

擴充套件安裝在每個使用者的擴充套件資料夾中。根據你的平臺，位置在以下資料夾中：

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

你可以透過使用 --extensions-dir <dir> 命令列選項啟動 VS Code 來更改位置。

或者，你可以將 VSCODE_EXTENSIONS 環境變數設定為你想要安裝擴充套件的位置。這在企業環境中非常有用，當你想集中管理使用者機器上擴充套件的安裝位置時。

每當我嘗試安裝任何擴充套件時，都會收到一個 connect ETIMEDOUT 錯誤

如果你的機器透過代理伺服器訪問網際網路，你可能會看到這個錯誤。詳情請參閱設定主題中的代理伺服器支援部分。

我可以直接從擴充套件市場下載擴充套件嗎？

一些使用者更喜歡從擴充套件市場下載一次擴充套件，然後從本地共享安裝到多個 VS Code 例項中。當存在連線問題或者你的開發團隊希望使用一組固定的擴充套件時，這很有用。

要下載擴充套件，請在擴充套件檢視中搜索它，右鍵單擊結果中的一個擴充套件，然後選擇 下載 VSIX 或 下載特定版本 VSIX。

我可以阻止 VS Code 提供擴充套件推薦嗎？

是的，如果你不希望 VS Code 在擴充套件檢視或透過通知顯示擴充套件推薦，你可以修改以下設定：

• extensions.showRecommendationsOnlyOnDemand - 設定為 true 以移除 推薦 部分。
• extensions.ignoreRecommendations - 設定為 true 以靜默擴充套件推薦通知。

如果你想檢視推薦，顯示推薦的擴充套件 命令始終可用。

我可以信任來自擴充套件市場的擴充套件嗎？

Visual Studio 擴充套件市場採取了多種措施來保護你免受惡意擴充套件的侵害，你也可以在安裝前執行各種步驟來判斷一個擴充套件是否可靠。

從 VS Code 1.97 版本開始，當你首次安裝來自第三方釋出者的擴充套件時，VS Code 會顯示一個對話方塊，提示你確認是否信任該擴充套件釋出者。

獲取更多關於擴充套件執行時安全的資訊。

VS Code 無法驗證擴充套件簽名

Visual Studio 擴充套件市場在釋出所有擴充套件時都會對其進行簽名。VS Code 在你安裝擴充套件時會驗證此簽名，以檢查擴充套件包的完整性和來源。

包完整性問題

對於包完整性問題，建議你聯絡 Visual Studio 擴充套件市場團隊 報告問題。請確保包含擴充套件 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 應用程式設定來控制組織中可以安裝哪些擴充套件。如果未配置該設定，則允許所有擴充套件。如果配置了該設定，所有未列出的擴充套件都將被阻止安裝。

獲取有關配置允許的擴充套件的更多詳細資訊。