💻 欢迎参加 6 月 3 日 MS Build 上的 VS Code 直播活动。

扩展市场

Visual Studio Code 开箱即用的功能仅仅是个开始。VS Code 扩展允许您向安装程序中添加语言、调试器和工具，以支持您的开发工作流程。VS Code 丰富的可扩展性模型使扩展作者能够直接插入 VS Code 用户界面，并通过 VS Code 使用的相同 API 贡献功能。本文介绍了如何从 Visual Studio Code Marketplace 查找、安装和管理 VS Code 扩展。

浏览扩展

您可以在 VS Code 内部浏览和安装扩展。通过单击 VS Code 侧边活动栏中的“扩展”图标，或使用 视图：扩展 命令（⇧⌘X (Windows, Linux Ctrl+Shift+X)）调出“扩展”视图。

Extensions view icon

这将向您显示 VS Code Marketplace 上最受欢迎的 VS Code 扩展列表。

popular extensions

列表中的每个扩展都包含简短的描述、发布者、下载量和五星级评分。您可以选择该扩展项以显示扩展详情页面，以便进一步了解。

注意

如果您的计算机是通过代理服务器访问互联网的，则需要配置代理服务器。详情请参阅 代理服务器支持。

安装扩展

要安装扩展，请选择 安装 按钮。安装完成后，安装 按钮将变为 管理 齿轮按钮。

重要

扩展与 VS Code 本身具有相同的权限。从 VS Code 1.97 版本开始，当您首次安装第三方发布者的扩展时，VS Code 会弹出一个对话框，提示您确认是否信任该扩展发布者。获取有关 扩展运行时安全性 以及如何保护自己免受恶意扩展侵害的更多信息。

如果您想安装扩展的特定版本，请右键单击该扩展并选择 安装其他版本。然后，您可以从可用列表中选择一个版本。

当启用了 设置同步 时，您可以跨机器共享 VS Code 配置（例如扩展）。要安装扩展但不将其同步到其他机器，请右键单击该扩展并选择 安装（不进行同步）。

查找并安装扩展

例如，让我们安装流行的 TODO Highlight 扩展。此扩展会高亮显示源代码中的 'TODO:' 和 'FIXME:' 等文本，以便您快速找到未完成的部分。

TODO Highlight extension highlighting in the editor

在“扩展”视图（⇧⌘X (Windows, Linux Ctrl+Shift+X)）中，在搜索框中输入 'todo'，以筛选 Marketplace 中标题或元数据中包含 'todo' 的扩展。您应该会在列表中看到 TODO Highlight 扩展。

Search for todo in the Extensions view

扩展由其发布者和扩展 ID 唯一标识。如果您选择 TODO Highlight 扩展，您将看到“扩展详情”页面，您可以在其中找到扩展 ID，本例中为 wayou.vscode-todo-highlight。如果有多个名称相似的扩展，了解扩展 ID 会很有帮助。

TODO Highlight extension details with extension ID highlighted

选择 安装 按钮，VS Code 将从 Marketplace 下载并安装该扩展。安装完成后，安装 按钮将被 管理 齿轮按钮替换。

Manage gear button

要查看 TODO Highlight 扩展的实际效果，请打开任何源代码文件并添加文本 'TODO:'，您将看到该文本被高亮显示。

TODO Highlight 扩展贡献了 TODO-Highlight: List highlighted annotations 和 TODO-Highlight: Toggle highlight 命令，您可以在命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）中找到它们。TODO-Highlight: Toggle highlight 命令允许您快速禁用或启用高亮显示。

TODO Highlight commands in the Command Palette

该扩展还提供了用于调整其行为的设置，您可以在设置编辑器（⌘, (Windows, Linux Ctrl+,)）中找到它们。例如，如果您希望文本搜索不区分大小写，可以取消勾选 Todohighlight: Is Case Sensitive 设置。

TODO Highlight settings in the Settings editor

如果扩展未提供您想要的功能，您可以随时通过 管理 按钮的上下文菜单 卸载 该扩展。

Uninstall the TODO Highlight extension

这只是如何安装和使用扩展的一个例子。VS Code Marketplace 有数以千计支持数百种编程语言和任务的扩展。从功能齐全的 Java、Python、Go 和 C++ 语言支持，到简单的 创建 GUID、更改 颜色主题 或在编辑器中添加 虚拟宠物 的扩展，应有尽有。

扩展详情

在扩展详情页面上，您可以阅读扩展的 README 并查看扩展的

  • 功能贡献 - 扩展对 VS Code 的增强功能，例如设置、命令和键盘快捷键、语言语法、调试器等。
  • 更新日志 - 扩展仓库的 CHANGELOG（如有提供）。
  • 依赖项 - 列出该扩展是否依赖于任何其他扩展。

extension contributions

如果扩展是一个扩展包，扩展包部分将显示安装该包时会安装哪些扩展。扩展包将多个单独的扩展捆绑在一起，以便可以一次性轻松安装。

Azure Tools extension pack

扩展视图筛选器和命令

您可以使用 筛选扩展 上下文菜单来筛选“扩展”视图。

Extensions view filter context menu

有以下筛选器可用：

  • 可更新的过时扩展列表
  • 当前已启用/已禁用扩展的列表
  • 基于您的工作区推荐的扩展列表
  • 全球热门扩展列表

您可以按 安装次数、评分、名称、发布日期 或 更新日期 对扩展列表进行升序或降序排序。您可以 在下方 了解更多关于扩展搜索筛选器的信息。

您可以通过 ... 查看和更多操作 按钮运行额外的“扩展”视图命令。

more button

通过此上下文菜单，您可以控制扩展更新、启用或禁用所有扩展，并使用 扩展二分查找 (Extension Bisect) 工具来隔离有问题的扩展行为。

搜索扩展

您可以清除“扩展”视图顶部的搜索框，并输入您要查找的扩展、工具或编程语言的名称。

例如，输入 'python' 将显示 Python 语言扩展列表

python extensions

如果您知道要查找的扩展的确切标识符，可以使用 @id: 前缀，例如 @id:vue.volar。此外，要筛选或排序结果，您可以使用下面详述的 筛选器 和 排序 命令。

安装扩展的预发布版本

扩展发布者可能会提供扩展的预发布版本。要安装预发布版本，请选择 安装 按钮上的下拉菜单，然后选择 安装预发布版本。

Install pre-release version

管理扩展

VS Code 让管理扩展变得简单。您可以通过“扩展”视图、命令面板（命令带有 Extensions: 前缀）或命令行开关来安装、禁用、更新和卸载扩展。

列出已安装的扩展

默认情况下，“扩展”视图将显示您当前已安装的扩展以及为您推荐的所有扩展。您可以使用 命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）或 更多操作 (...) 下拉菜单 > 视图 > 已安装 中的 Extensions: Focus on Installed View 命令，清除搜索框中的任何文本并显示所有已安装扩展的列表，其中包括已禁用的扩展。

卸载扩展

要卸载扩展，请选择扩展条目右侧的 管理 齿轮按钮，然后从下拉菜单中选择 卸载。这将卸载扩展并提示您重启扩展宿主（重启扩展）。

uninstall an extension

禁用扩展

如果您不想永久删除扩展，可以单击扩展条目右侧的齿轮按钮临时禁用该扩展。您可以全局禁用扩展，也可以仅针对当前工作区禁用。禁用扩展后，系统将提示您重启扩展宿主（重启扩展）。

如果您想快速禁用所有已安装的扩展，命令面板 和 更多操作 (...) 下拉菜单中有一个 禁用所有已安装的扩展 命令。

扩展在所有 VS Code 会话中将保持禁用状态，直到您重新启用它们。

启用扩展

同样，如果您已禁用某个扩展（它将出现在列表的 已禁用 部分并标记为 已禁用），您可以使用下拉菜单中的 启用 或 启用 (工作区) 命令重新启用它。

enable extension

更多操作 (...) 下拉菜单中还有一个 启用所有扩展 命令。

扩展自动更新

VS Code 会检查扩展更新并自动安装它们。更新后，系统会提示您重启扩展宿主（重启扩展）。

如果您更喜欢手动更新扩展，可以使用 禁用所有扩展的自动更新 命令或“扩展”视图中的相应操作来禁用自动更新。您还可以配置 extensions.autoUpdate 在 VS Code 中打开 在 VS Code Insiders 中打开 设置。使用 启用所有扩展的自动更新 命令可重新启用自动更新。

Disable auto update for all extensions action

您还可以通过右键单击扩展并切换 自动更新 项目来配置单个扩展的自动更新。

如果您不想让 VS Code 检查更新，可以将 extensions.autoCheckUpdates 在 VS Code 中打开 在 VS Code Insiders 中打开 设置为 false。

手动更新扩展

如果您禁用了扩展自动更新，可以使用 显示过时的扩展 命令快速查找扩展更新，该命令使用 @updates 筛选器。这将显示您当前安装的扩展可用的任何更新。

选择过时扩展的 更新 按钮。更新将安装，并且系统会提示您重启扩展宿主（重启扩展）。您还可以使用 更新所有扩展 命令一次性更新所有过时的扩展。

如果您还禁用了自动检查更新，可以使用 检查扩展更新 命令来查看哪些扩展可以更新。

推荐的扩展

您可以使用 显示推荐的扩展 查看推荐扩展列表，这会设置 @recommended 筛选器。扩展推荐可以是

  • 工作区推荐 - 由您当前工作区的其他用户推荐。
  • 其他推荐 - 基于最近打开的文件进行的推荐。

请参阅下面的部分，了解如何为项目中的其他用户 贡献 推荐建议。

忽略推荐

要忽略某项推荐，请选择扩展项以打开“详情”页面，然后选择 管理 齿轮按钮以显示上下文菜单。选择 忽略推荐 菜单项。被忽略的推荐将不再向您推荐。

Ignore extension recommendation

配置扩展

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。

extension identifier

扩展视图筛选器

“扩展”视图搜索框支持筛选器，以帮助您查找和管理扩展。如果您使用了 显示已安装的扩展 和 显示推荐的扩展 命令，您可能已经看到了诸如 @installed 和 @recommended 等筛选器。此外，还有可用于按流行度或评分排序以及按类别（例如 'Linters'）和标签（例如 'node'）搜索的筛选器。通过在扩展搜索框中键入 @ 并浏览建议，您可以看到所有筛选器和排序命令的完整列表。

intellisense on extension search filters

以下是一些“扩展”视图筛选器

  • @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 - 按扩展最后更新日期排序。

sort by install count

类别和标签

扩展可以设置描述其功能的 类别 (Categories) 和 标签 (Tags)。

extension categories and tags

您可以使用 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 进行访问

categories debuggers

请注意，如果类别名称超过一个单词，您必须将其括在引号中（例如，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 以同时安装多个扩展。

注意

当您通过 VSIX 安装扩展时，该扩展的 自动更新 默认处于禁用状态。

如果您想了解有关打包和发布扩展的更多信息，请参阅扩展 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"]
}

它推荐了一个 linter 扩展和一个代码格式化扩展。

扩展通过其发布者标识符和扩展标识符 publisher.extension 来标识。您可以在扩展详情页面上看到该名称。VS Code 将在这些文件中为您提供已安装扩展的自动补全功能。

Extension identifier.

当首次打开工作区时，VS Code 会提示用户安装推荐的扩展。用户也可以使用 Extensions: Show Recommended Extensions 命令查看该列表。

Show Recommendations

后续步骤

以下是一些您可能会感兴趣的主题...

常见问题

扩展安装在哪里？

扩展安装在每个用户的扩展文件夹中。根据您的平台，位置位于以下文件夹中

  • 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 在 VS Code 中打开 在 VS Code Insiders 中打开 - 设置为 true 以移除 RECOMMENDED 部分。
  • extensions.ignoreRecommendations 在 VS Code 中打开 在 VS Code Insiders 中打开 - 设置为 true 以静默扩展推荐通知。

如果您想查看推荐，显示推荐的扩展 命令始终可用。

我能信任 Marketplace 上的扩展吗？

Visual Studio Marketplace 采取了多项措施来保护您免受恶意扩展的侵害，您也可以在安装扩展之前采取各种步骤来确定扩展是否可靠。

从 VS Code 1.97 版本开始，当您首次安装第三方发布者的扩展时，VS Code 会弹出一个对话框，提示您确认是否信任该扩展发布者。

获取有关 扩展运行时安全性 的更多信息。

我可以为我的组织在内部托管扩展吗？

是的，请参阅 私有扩展 Marketplace。

扩展签名无法被 VS Code 验证

Visual Studio Marketplace 在发布所有扩展时都会对其进行签名。当您安装扩展时，VS Code 会验证此签名，以检查扩展包的完整性和来源。

重要

安装扩展时，您可能会看到以下错误消息：Cannot install extension because Visual Studio Code cannot verify the extension signature（由于 Visual Studio Code 无法验证扩展签名，无法安装扩展）。此错误可能由多种原因引起，如果您遇到此错误，请在决定继续安装之前务必谨慎。可以通过 extensions.verifySignature 在 VS Code 中打开 在 VS Code Insiders 中打开 设置来禁用扩展签名验证。

包完整性问题

对于包完整性问题，建议您联系 Visual Studio Marketplace 团队 报告此问题。请确保包含扩展 ID。以下列表提供了与包完整性问题相关的错误代码

PackageIntegrityCheckFailed
SignatureIsInvalid
SignatureManifestIsInvalid
SignatureIntegrityCheckFailed
EntryIsMissing
EntryIsTampered
Untrusted
CertificateRevoked
SignatureIsNotValid
SignatureArchiveHasTooManyEntries
NotSigned

其他问题

对于不支持的环境或未知原因等其他问题，建议您通过提供所有必要信息并包含共享日志来 报告问题：⇧⌘P (Windows, Linux Ctrl+Shift+P) > 打开视图... > 共享。

当连接到远程窗口时，我的扩展不同步

设置同步 让您可以跨机器共享 Visual Studio Code 配置（例如设置、键盘快捷键和已安装的扩展），以便您始终使用自己喜欢的设置工作。

VS Code 不会向远程窗口同步您的扩展，或者从远程窗口同步，例如当您连接到 SSH、开发容器 (devcontainer) 或 WSL 时。

我可以在我的组织中允许或阻止特定的扩展吗？

您可以通过配置 extensions.allowed 应用程序设置来控制组织中可以安装哪些扩展。如果未配置该设置，则允许所有扩展。如果配置了该设置，则禁止安装所有未列出的扩展。

获取有关 配置允许的扩展 的更多详情。

02/04/2026
English 한국어 中文(简体) 中文(繁體)
© . This site is unofficial and not affiliated with Microsoft.