擴充功能市集

Visual Studio Code 內建的功能只是個開始。VS Code 擴充功能可讓您將語言、偵錯工具和工具新增到您的安裝中，以支援您的開發工作流程。VS Code 豐富的擴充性模型可讓擴充功能作者直接插入 VS Code UI，並透過 VS Code 使用的相同 API 貢獻功能。本文說明如何從 Visual Studio Code Marketplace 尋找、安裝及管理 VS Code 擴充功能。

瀏覽擴充功能

您可以在 VS Code 內部瀏覽並安裝擴充功能。點擊 VS Code 側邊活動列中的擴充功能圖示，或執行 View: Extensions 命令 (⇧⌘X (Windows、Linux Ctrl+Shift+X))，即可開啟擴充功能檢視。

這將會顯示 VS Code Marketplace 上最受歡迎的 VS Code 擴充功能清單。

清單中的每個擴充功能都包含簡要說明、發行者、下載次數和五星評價。您可以選擇擴充功能項目以顯示擴充功能的詳細資訊頁面，在那裡您可以了解更多資訊。

安裝擴充功能

若要安裝擴充功能，請選擇安裝按鈕。安裝完成後，安裝按鈕將變為管理齒輪按鈕。

如果您想安裝特定版本的擴充功能，請右鍵點擊該擴充功能並選擇 Install Another Version (安裝其他版本)。然後您可以從可用清單中選擇一個版本。

當設定同步啟用時，您可以在您的機器之間分享 VS Code 配置，例如擴充功能。若要安裝擴充功能且不跨機器同步，請右鍵點擊該擴充功能並選擇 Install (Do not Sync) (安裝 (不同步))。

尋找並安裝擴充功能

舉例來說，讓我們安裝受歡迎的 TODO Highlight 擴充功能。這個擴充功能會反白您的原始碼中像 'TODO:' 和 'FIXME:' 這樣的文字，讓您可以快速找到尚未完成的部分。

在擴充功能檢視 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 中，在搜尋方塊中輸入 'todo' 以篩選 Marketplace 中標題或中繼資料包含 'todo' 的擴充功能。您應該會在清單中看到 TODO Highlight 擴充功能。

擴充功能透過其發行者和擴充功能 ID 唯一識別。如果您選擇 TODO Highlight 擴充功能，您將會看到擴充功能詳細資訊頁面，您可以在其中找到擴充功能 ID，在本例中為 wayou.vscode-todo-highlight。如果有多個名稱相似的擴充功能，知道擴充功能 ID 會很有幫助。

選擇安裝按鈕，VS Code 將會從 Marketplace 下載並安裝此擴充功能。安裝完成後，安裝按鈕將替換為管理齒輪按鈕。

若要實際查看 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 Marketplace 擁有數千種擴充功能，支援數百種程式語言和任務。從針對 Java、Python、Go 和 C++ 的功能齊全的語言支援，到 建立 GUID、更改 色彩主題 或為編輯器新增 虛擬寵物 的簡單擴充功能，應有盡有。

擴充功能詳細資訊

在擴充功能詳細資訊頁面，您可以閱讀擴充功能的 README 並檢視擴充功能的

• 功能貢獻 - 擴充功能對 VS Code 的新增功能，例如設定、命令和鍵盤快速鍵、語言文法、偵錯工具等。
• 變更日誌 - 如果可用，擴充功能儲存庫的 CHANGELOG。
• 相依性 - 列出擴充功能是否依賴於任何其他擴充功能。

如果擴充功能是擴充功能套件，則擴充功能套件區塊將顯示當您安裝套件時將安裝哪些擴充功能。擴充功能套件將單獨的擴充功能捆綁在一起，以便一次輕鬆安裝。

擴充功能檢視篩選器與命令

您可以使用篩選擴充功能內容選單來篩選擴充功能檢視。

有些篩選器可以顯示

• 可更新的過期擴充功能清單
• 目前已啟用/已停用擴充功能的清單
• 根據您的工作區建議的擴充功能清單
• 全球受歡迎的擴充功能清單

您可以根據安裝次數、評分、名稱、發行日期或更新日期，以遞增或遞減順序排序擴充功能清單。您可以從下方了解更多有關擴充功能搜尋篩選器的資訊。

您可以透過 ... 檢視及更多動作按鈕執行其他擴充功能檢視命令。

透過此內容選單，您可以控制擴充功能更新、啟用或停用所有擴充功能，並使用 擴充功能二分搜尋 工具來隔離有問題的擴充功能行為。

搜尋擴充功能

您可以清除擴充功能檢視頂部的搜尋方塊，然後輸入您正在尋找的擴充功能、工具或程式語言的名稱。

例如，輸入 'python' 將會顯示 Python 語言擴充功能清單

如果您知道要尋找的擴充功能的確切識別碼，可以使用 @id: 前綴，例如 @id:vue.volar。此外，若要篩選或排序結果，您可以使用下方詳述的篩選和排序命令。

安裝擴充功能預覽版

擴充功能發行者可能會提供擴充功能的預覽版。若要安裝預覽版，請點擊安裝按鈕上的下拉式選單並選擇 Install Pre-Release Version (安裝預覽版)。

管理擴充功能

VS Code 可讓您輕鬆管理擴充功能。您可以透過擴充功能檢視、命令選擇區 (命令具有 Extensions: 前綴) 或命令列參數來安裝、停用、更新和解除安裝擴充功能。

列出已安裝的擴充功能

預設情況下，擴充功能檢視會顯示您目前已安裝的擴充功能，以及所有為您建議的擴充功能。您可以使用 Extensions: Focus on Installed View (擴充功能：聚焦已安裝檢視) 命令，該命令可在命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 或更多動作 (...) 下拉式選單 > 檢視 > 已安裝中找到，以清除搜尋方塊中的任何文字並顯示所有已安裝擴充功能的清單，其中包括已停用的擴充功能。

解除安裝擴充功能

若要解除安裝擴充功能，請選擇擴充功能項目右側的管理齒輪按鈕，然後從下拉式選單中選擇解除安裝。這將解除安裝擴充功能並提示您重新啟動擴充功能主機 (Restart Extensions)。

停用擴充功能

如果您不想永久移除擴充功能，您可以改為點擊擴充功能項目右側的齒輪按鈕來暫時停用擴充功能。您可以全域停用擴充功能，或僅針對您目前的工作區停用。停用擴充功能後，系統將提示您重新啟動擴充功能主機 (Restart Extensions)。

如果您想快速停用所有已安裝的擴充功能，在命令選擇區和更多動作 (...) 下拉式選單中有一個 Disable All Installed Extensions (停用所有已安裝擴充功能) 命令。

擴充功能將在所有 VS Code 工作階段中保持停用狀態，直到您重新啟用它們為止。

啟用擴充功能

同樣地，如果您已停用某個擴充功能 (它將位於清單的已停用區段中並標記為已停用)，您可以使用下拉式選單中的啟用或啟用 (工作區) 命令來重新啟用它。

在更多動作 (...) 下拉式選單中也有一個 Enable All Extensions (啟用所有擴充功能) 命令。

擴充功能自動更新

VS Code 會檢查擴充功能更新並自動安裝它們。更新後，系統會提示您重新啟動擴充功能主機 (Restart Extensions)。

如果您更喜歡手動更新擴充功能，您可以使用 Disable Auto Update for All Extensions (停用所有擴充功能自動更新) 命令或擴充功能檢視中的相應動作來停用自動更新。您還可以設定 extensions.autoUpdate 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定。使用 Enable Auto Update for All Extensions (啟用所有擴充功能自動更新) 命令重新啟用自動更新。

您也可以透過右鍵點擊擴充功能並切換自動更新項目來設定個別擴充功能的自動更新。

如果您甚至不想讓 VS Code 檢查更新，您可以將 extensions.autoCheckUpdates 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定為 false。

手動更新擴充功能

如果您已停用擴充功能自動更新，您可以使用 Show Outdated Extensions (顯示過期擴充功能) 命令 (該命令使用 @updates 篩選器) 快速尋找擴充功能更新。這將會顯示您目前已安裝擴充功能的任何可用更新。

選擇過期擴充功能的更新按鈕。更新將會安裝，並且系統將提示您重新啟動擴充功能主機 (Restart Extensions)。您也可以使用 Update All Extensions (更新所有擴充功能) 命令一次更新所有過期的擴充功能。

如果您也已停用自動檢查更新，您可以使用 Check for Extension Updates (檢查擴充功能更新) 命令來檢查您的哪些擴充功能可以更新。

建議的擴充功能

您可以使用 Show Recommended Extensions (顯示建議的擴充功能) 來查看建議的擴充功能清單，該命令設定了 @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.

您可以在擴充功能詳細資訊頁面的「Marketplace 資訊」下方看到擴充功能 ID。

擴充功能檢視篩選器

擴充功能檢視搜尋方塊支援篩選器，可幫助您尋找和管理擴充功能。如果您使用過 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:主題
  • @category:格式化工具
  • @category:程式碼檢查工具
  • @category:程式碼片段

這些篩選器也可以組合使用。例如：使用 @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 擴充功能。使用擴充功能檢視命令下拉式選單中的 Install from VSIX (從 VSIX 安裝) 命令，或命令選擇區中的 Extensions: Install from VSIX (擴充功能：從 VSIX 安裝) 命令，指向 .vsix 檔案。

您也可以使用 VS Code 的 --install-extension 命令列開關來安裝，提供 .vsix 檔案的路徑。

code --install-extension myextension.vsix

您可以在命令列中多次提供 --install-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 (擴充功能：顯示建議的擴充功能) 命令來檢視清單。

後續步驟

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

• 擴充功能 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 實例。這在有連線問題或您的開發團隊想要使用一組固定擴充功能時很有用。

若要下載擴充功能，請在擴充功能檢視中搜尋它，右鍵點擊結果中的擴充功能，然後選擇 Download VSIX (下載 VSIX) 或 Download Specific Version VSIX (下載特定版本 VSIX)。

我可以阻止 VS Code 提供擴充功能建議嗎？

是的，如果您不希望 VS Code 在擴充功能檢視中或透過通知顯示擴充功能建議，您可以修改以下設定

• extensions.showRecommendationsOnlyOnDemand 在 VS Code 中開啟 在 VS Code Insiders 中開啟 - 設定為 true 可移除建議區段。
• extensions.ignoreRecommendations 在 VS Code 中開啟 在 VS Code Insiders 中開啟 - 設定為 true 可關閉擴充功能建議通知。

如果您想查看建議，Show Recommended Extensions (顯示建議擴充功能) 命令始終可用。

我可以信任來自 Marketplace 的擴充功能嗎？

Visual Studio Marketplace 採取了多種措施來保護您免受惡意擴充功能的侵害，您也可以在安裝擴充功能之前執行各種步驟來判斷其是否可靠。

自 VS Code 1.97 版本起，當您第一次從第三方發行者安裝擴充功能時，VS Code 會顯示一個對話框，提示您確認是否信任該擴充功能發行者。

了解更多有關擴充功能執行時安全性的資訊。

我可以為我的組織內部託管擴充功能嗎？

是的，請參閱擴充功能專用 Marketplace。

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 應用程式設定來控制哪些擴充功能可以在您的組織中安裝。如果未設定此設定，則允許所有擴充功能。如果已設定此設定，則未列出的所有擴充功能將被阻止安裝。

了解更多關於設定允許的擴充功能的詳細資訊。