擴充功能市集

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 擴充功能清單。

清單中的每個擴充功能都包含簡短描述、發行者、下載次數和五星評等。您可以選取擴充功能項目以顯示擴充功能的詳細資料頁面，您可以在其中瞭解更多資訊。

安裝擴充功能

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

如果您想要安裝特定版本的擴充功能，請在擴充功能上按一下滑鼠右鍵，然後選取安裝另一個版本。然後，您可以從可用的清單中選取版本。

當設定同步啟用時，您可以跨機器共用您的 VS Code 組態，例如擴充功能。若要安裝擴充功能但不跨機器同步它，請在擴充功能上按一下滑鼠右鍵，然後選取安裝 (不同步)。

尋找並安裝擴充功能

例如，讓我們安裝熱門的 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。此外，若要篩選或排序結果，您可以使用篩選器和排序命令，詳細資訊如下。

安裝預先發佈的擴充功能版本

擴充功能發行者可能會提供擴充功能的預先發佈版本。若要安裝預先發佈版本，請選取安裝按鈕上的下拉式選單，然後選取安裝預先發佈版本。

管理擴充功能

VS Code 讓您能夠輕鬆管理擴充功能。您可以透過「擴充功能」檢視、命令面板 (命令具有 Extensions: 前置詞) 或命令列開關來安裝、停用、更新和解除安裝擴充功能。

列出已安裝的擴充功能

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

解除安裝擴充功能

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

停用擴充功能

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

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

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

啟用擴充功能

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

在更多動作 (...) 下拉式選單中，還有 Enable All Extensions 命令。

擴充功能自動更新

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

如果您寧願手動更新擴充功能，您可以停用所有擴充功能的自動更新命令，或是使用「擴充功能」檢視中的對應動作來停用自動更新。您也可以設定 extensions.autoUpdate 設定。使用「啟用所有擴充功能的自動更新」命令來重新啟用自動更新。

您也可以透過在擴充功能上按一下滑鼠右鍵並切換 Auto Update 項目，來設定個別擴充功能的自動更新。

如果您不希望 VS Code 甚至檢查更新，您可以將 extensions.autoCheckUpdates 設定設為 false。

手動更新擴充功能

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

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

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

建議的擴充功能

您可以使用 Show Recommended Extensions 來查看建議的擴充功能清單，這會設定 @recommended 篩選器。擴充功能建議可以是

• 工作區建議 - 由您目前工作區的其他使用者建議。
• 其他建議 - 根據最近開啟的檔案建議。

請參閱以下章節，瞭解如何為專案中的其他使用者貢獻建議。

忽略建議

若要關閉建議，請在擴充功能項目上選取以開啟「詳細資料」頁面，然後選取管理齒輪按鈕以顯示內容功能表。選取忽略建議功能表項目。忽略的建議將不再建議給您。

設定擴充功能

VS Code 擴充功能可能具有非常不同的組態和需求。某些擴充功能會將設定貢獻給 VS Code，這些設定可以在設定編輯器中修改。其他擴充功能可能有自己的組態檔。擴充功能也可能需要安裝和設定其他組件，例如編譯器、偵錯工具和命令列工具。請參閱擴充功能的 README (在「擴充功能」檢視詳細資料頁面中可見)，或前往 VS Code Marketplace 上的擴充功能頁面 (按一下詳細資料頁面中的擴充功能名稱)。許多擴充功能都是開放原始碼，並且在其 Marketplace 頁面上有其存放庫的連結。

命令列擴充功能管理

為了更容易自動化和設定 VS Code，可以從命令列列出、安裝和解除安裝擴充功能。在識別擴充功能時，請提供格式為 發行者.擴充功能 的完整名稱，例如 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> | <extension-vsix-path>)
    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。

擴充功能檢視篩選器

「擴充功能」檢視搜尋方塊支援篩選器，以協助您尋找和管理擴充功能。如果您使用過「顯示已安裝的擴充功能」和「顯示建議的擴充功能」命令，您可能已經看過篩選器，例如 @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 安裝命令，或命令面板中的 Extensions: Install from VSIX 命令，指向 .vsix 檔案。

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

code --install-extension myextension.vsix

您可以在命令列上多次提供 --install-extension，以一次安裝多個擴充功能。

如果您想瞭解更多關於封裝和發佈擴充功能的資訊，請參閱我們擴充功能 API 中的 發佈擴充功能 文章。

工作區建議的擴充功能

一組良好的擴充功能可以讓使用特定工作區或程式設計語言更有效率，而且您通常會想要與您的團隊或同事共用此清單。您可以使用 Extensions: Configure Recommended Extensions (Workspace Folder) 命令，為工作區建立建議的擴充功能清單。

在單一資料夾工作區中，此命令會在工作區 .vscode 資料夾中建立 extensions.json 檔案，您可以在其中新增擴充功能識別碼清單 ({發行者名稱}.{擴充功能名稱})。

在多根目錄工作區中，此命令將會開啟您的 .code-workspace 檔案，您可以在其中列出 extensions.recommendations 下的擴充功能。您仍然可以使用 Extensions: Configure Recommended Extensions (Workspace Folder) 命令，將擴充功能建議新增至多根目錄工作區中的個別資料夾。

extensions.json 的範例可能如下所示

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

這會建議程式碼檢查擴充功能和程式碼格式器擴充功能。

擴充功能是使用其發行者識別碼和擴充功能識別碼 發行者.擴充功能 來識別的。您可以在擴充功能的詳細資料頁面上看到名稱。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 來變更位置。

每當我嘗試安裝任何擴充功能時，都會收到連線 ETIMEDOUT 錯誤

如果您的機器透過 Proxy 伺服器存取網際網路，您可能會看到此錯誤。如需詳細資訊，請參閱設定主題中的Proxy 伺服器支援章節。

我可以直接從 Marketplace 下載擴充功能嗎？

有些使用者偏好從 Marketplace 下載一次擴充功能，然後從本機共用安裝到多個 VS Code 執行個體。當有連線問題或您的開發團隊想要使用一組固定的擴充功能時，這非常有用。

若要下載擴充功能，請在「擴充功能」檢視中搜尋它，從結果中在擴充功能上按一下滑鼠右鍵，然後選取下載 VSIX。

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

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

• extensions.showRecommendationsOnlyOnDemand - 設定為 true 可移除 RECOMMENDED 區段。
• extensions.ignoreRecommendations - 設定為 true 可關閉擴充功能建議通知。

如果您想要查看建議，Show Recommended Extensions 命令隨時可用。

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

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

從 VS Code 1.97 版開始，當您第一次從協力廠商發行者安裝擴充功能時，VS Code 會顯示一個對話方塊，提示您確認您信任該擴充功能發行者。

如需更多關於擴充功能執行階段安全性的資訊，請參閱相關文件。

擴充功能簽章無法由 VS Code 驗證

Visual Studio Marketplace 會在所有擴充功能發佈時簽署它們。當您安裝擴充功能時，VS Code 會驗證此簽章，以檢查擴充功能套件的完整性和來源。

當您安裝擴充功能時，您可能會看到下列錯誤訊息：無法安裝擴充功能，因為 Visual Studio Code 無法驗證擴充功能簽章。

此錯誤可能是由各種原因造成的，例如不受支援的環境，甚至 (不太可能) 套件完整性問題。如果您遇到此錯誤，在決定安裝之前請務必謹慎。

建議您聯絡 Visual Studio Marketplace 團隊 以報告此問題。請務必包含擴充功能 ID。如果您想要停用擴充功能簽章驗證，您可以使用 extensions.verifySignature 設定。

當連線到遠端視窗時，我的擴充功能不會同步

設定同步可讓您跨機器共用 Visual Studio Code 組態 (例如設定、鍵盤快速鍵和已安裝的擴充功能)，以便您始終使用您最愛的設定工作。

VS Code 不會將您的擴充功能同步到或從遠端視窗同步，例如當您連線到 SSH、開發容器 (devcontainer) 或 WSL 時。

我可以在我的組織中允許或封鎖特定擴充功能嗎？

您可以透過設定 extensions.allowed 應用程式設定，控制可以在您的組織中安裝哪些擴充功能。如果未設定此設定，則允許所有擴充功能。如果已設定此設定，則所有未列出的擴充功能都會被封鎖安裝。

如需更多關於設定允許的擴充功能的詳細資訊，請參閱相關文件。