扩展市场
Visual Studio Code 包含的功能只是个开始。VS Code 扩展允许您在安装中添加语言、调试器和工具,以支持您的开发工作流程。VS Code 丰富的可扩展性模型允许扩展作者直接插入 VS Code UI 并通过与 VS Code 使用的相同 API 贡献功能。本文解释了如何从 Visual Studio Code 市场中查找、安装和管理 VS Code 扩展。
浏览扩展
你可以在 VS Code 内浏览和安装扩展。通过点击 VS Code 侧边栏中的扩展图标或“视图:扩展”命令(活动栏)来打开扩展视图,或使用命令(视图:扩展)(⇧⌘X(Windows, Linux Ctrl+Shift+X))。
![]()
这将向您展示 VS Code 市场上最受欢迎的 VS Code 扩展列表。

每个扩展在列表中都包括简短的描述、发布者、下载次数和五星评分。您可以选择扩展项以显示扩展的详细页面,在那里您可以了解更多信息。
如果您的计算机通过代理服务器访问互联网,您将需要配置代理服务器。请参阅代理服务器支持了解详细信息。
安装扩展
要安装扩展,请选择安装按钮。安装完成后,安装按钮将变为管理齿轮按钮。
扩展与 VS Code 本身具有相同的权限。截至 VS Code 1.97 版本,当您首次从第三方发布者安装扩展时,VS Code 会显示一个对话框,提示您确认是否信任该扩展发布者。获取有关扩展运行时安全以及如何保护自己免受恶意扩展侵害的更多信息。
如果您想安装特定版本的扩展,请右键单击该扩展并选择安装另一个版本。然后您可以从可用列表中选择一个版本。
当设置同步启用时,您可以在不同的机器之间共享您的 VS Code 配置,例如扩展。要安装一个扩展而不将其同步到您的所有机器,请右键单击该扩展并选择安装(不同步)。
查找并安装扩展
例如,让我们安装流行的TODO Highlight扩展。这个扩展会将源代码中的文本像 'TODO:' 和 'FIXME:' 一样突出显示,这样你就可以快速找到未完成的部分。

在扩展视图中 (⌫X (Windows, Linux ⌫+Shift+X)),在搜索框中输入 'todo' 以筛选包含 'todo' 在标题或元数据中的市场扩展。你应该会在列表中看到 TODO Highlight 扩展。

扩展通过其发布者和扩展ID唯一标识。如果你选择待办事项高亮扩展,你将看到扩展详细信息页面,在此你可以找到扩展ID,即wayou.vscode-todo-highlight知道扩展ID在有多个同名扩展时可能会很有帮助。

选择安装按钮,VS Code将从市场下载并安装扩展。当安装完成后,安装按钮将被替换为一个管理齿轮按钮。

要查看TODO Highlight扩展的效果,请打开任何源代码文件并添加文本_TODO:_, 您将看到文本被突出显示。
TODO Highlight扩展贡献了命令,TODO-Highlight: 列出已高亮的注释和TODO-Highlight: 切换高亮,你可以在命令面板中找到这些命令(⇧⌘P(Windows, Linux Ctrl+Shift+P))。命令TODO-Highlight: 切换高亮允许你快速禁用或启用高亮。

该扩展还提供了用于调整其行为的设置,您可以在设置编辑器中找到这些设置 (⌘, (Windows, Linux Ctrl+,))。例如,您可能希望文本搜索不区分大小写,您可以取消选中 Todohighlight: 是区分大小写 的设置。

如果一个扩展不提供你想要的功能,你可以随时卸载该扩展,方法是通过管理按钮的上下文菜单。

这只是如何安装和使用扩展的一个例子。VS Code 市场上有成千上万的扩展,支持数百种编程语言和任务。Java、Python、Go和C++的完整功能语言支持,到简单的扩展,如创建GUID、更改颜色主题或在编辑器中添加虚拟宠物。
扩展详情
在扩展详情页面,您可以阅读扩展的README并查看扩展的:
- 功能贡献 - 该扩展对 VS Code 的添加,例如设置、命令和键盘快捷键、语言语法、调试器等。
- 更新日志 - 如果可用,扩展库的更新日志。
- 依赖关系 - 列出该扩展是否依赖于任何其他扩展。

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

扩展视图过滤器和命令
您可以使用过滤扩展上下文菜单过滤扩展视图。

有筛选器显示:
- 可以更新的过时扩展列表
- 当前启用/禁用的扩展列表
- 根据您的工作区推荐的扩展列表
- 全球热门扩展列表
您可以按 安装次数、评分、名称、发布日期或 更新日期 进行排序,升序或降序。您可以在此 下方 了解更多关于扩展搜索过滤器的信息。
您可以通过以下命令运行附加的扩展视图命令请输入具体的网页文本内容,以便我进行翻译。 查看和更多操作 按钮。

通过此上下文菜单,您可以控制扩展更新、启用或禁用所有扩展,并使用扩展 Bisect工具来隔离有问题的扩展行为。
搜索扩展
您可以在扩展视图顶部的搜索框中清除内容,并输入您正在寻找的扩展、工具或编程语言的名称。
例如,输入“python”将显示Python语言扩展的列表:

如果你知道你要查找的扩展的确切标识符,你可以使用@id:前缀,例如@id:vue.volar此外,要筛选或排序结果,您可以使用筛选和排序命令,详细内容如下。
安装预发布扩展版本
扩展发布者可能会提供扩展的预发布版本。要安装预发布版本,请选择 安装 按钮上的下拉菜单并选择 安装预发布版本。

管理扩展
VS Code 使管理扩展变得简单。您可以通过扩展视图、命令面板(命令具有扩展:前缀)或命令行开关来安装、禁用、更新和卸载扩展。
列出已安装的扩展
默认情况下,扩展视图将显示您当前安装的扩展以及所有推荐给您的扩展。您可以使用扩展:聚焦已安装视图命令,该命令可在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P))或在更多操作 (请输入具体的网页文本内容,以便我进行翻译。) 下拉菜单 > 视图 > 已安装,清除搜索框中的任何文本并显示所有已安装的扩展列表,包括那些已禁用的扩展。
卸载扩展
要卸载扩展,请选择扩展条目的右侧的管理齿轮按钮,然后从下拉菜单中选择卸载。这将卸载扩展并提示您重启扩展主机(重启扩展)。

禁用一个扩展
如果您不想永久删除扩展,请可以点击扩展条目右侧的齿轮按钮临时禁用扩展。您可以全局禁用扩展或仅禁用当前的Workspace。禁用扩展后,系统会提示您重启扩展主机(重启扩展)。
如果你想快速禁用所有已安装的扩展,请在命令面板中使用禁用所有已安装的扩展命令和更多操作 (请输入具体的网页文本内容,以便我进行翻译。) 下拉菜单。
在你重新启用它们之前,所有 VS Code 会话中的扩展将保持禁用状态。
启用扩展
同样,如果你禁用了某个扩展(它将出现在列表的禁用部分,并标记为禁用),你可以通过下拉菜单中的启用或启用(工作区)命令重新启用它。

还有一个启用所有扩展命令在更多操作 (请输入具体的网页文本内容,以便我进行翻译。) 下拉菜单。
扩展自动更新
VS Code自动检查扩展更新并安装它们。更新后,系统会提示您重启扩展主机 (重启扩展)。
如果你更喜欢手动更新扩展,你可以使用禁用所有扩展的自动更新命令或扩展视图中的相应操作来禁用自动更新。你也可以配置

您还可以通过右键单击扩展并切换自动更新项来为单个扩展配置自动更新。
如果您不想让 VS Code 检查更新,您可以设置
手动更新扩展
如果你禁用了扩展自动更新,你可以通过使用显示过时的扩展命令来快速查找扩展更新,该命令使用@更新过滤器。这将显示您当前安装的扩展程序的任何可用更新。
选择更新按钮以更新过时的扩展。更新将被安装,并且您将被提示重新启动扩展主机(重新启动扩展)。您还可以使用更新所有扩展命令一次更新所有过时的扩展。
如果你也禁用了自动更新检查,你可以使用检查扩展更新命令来检查哪些扩展可以更新。
推荐的扩展
您可以使用 显示推荐的扩展查看推荐的扩展列表,这将设置 @推荐 过滤器。扩展推荐可以是:
- 工作区推荐 - 由您当前工作区的其他用户推荐。
- 其他建议 - 基于最近打开的文件建议。
请参阅下面的部分以了解如何贡献您项目中其他用户的建议。
忽略建议
要忽略建议,请选择扩展项目以打开详细信息页面,然后选择管理齿轮按钮以显示上下文菜单。选择忽略建议菜单项。忽略的建议将不再向您推荐。

配置扩展
VS Code 扩展可能具有非常不同的配置和要求。一些扩展贡献设置到 VS Code,可以在设置编辑器中进行修改。其他扩展可能有自己单独的配置文件。扩展还可能需要安装和设置额外的组件,例如编译器、调试器和命令行工具。查阅扩展的 README(在扩展视图的详细页面中可见)或访问VS Code 市场上的扩展页面(在详细页面中点击扩展名称)。许多扩展是开源的,并且在他们的市场页面上有一个链接到他们的代码库。
命令行扩展管理
为了更容易地自动化和配置 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>)
卸载 一个 插件。
代码 --enable-proposed-api (<插件ID>)
启用 提议的 API 功能 用于 插件。 可以 接收 一个 或者 更多 插件 ID 来 个别启用。
您可以在市场信息下的扩展详细信息页面看到扩展ID。

扩展视图过滤器
扩展视图搜索框支持过滤器,帮助您找到和管理扩展。您可能已经看到过滤器,例如@已安装和@推荐 如果你使用了命令 显示已安装的扩展 和 显示推荐的扩展。此外,还有过滤器可以让你按受欢迎程度或评分排序,并按类别(例如 'Linters')和标签(例如 'node')搜索。你可以通过输入 来查看所有过滤器和排序命令的完整列表。@在扩展搜索框中并浏览建议:

以下是一些扩展视图过滤器:
@内置- 显示与 VS Code 一起提供的扩展。按类型分组(编程语言、主题等)。@已弃用- 显示已弃用的扩展。@禁用- 显示已禁用的已安装扩展。@启用- 显示已启用的已安装扩展。扩展可以单独启用/禁用。@精选- 显示精选扩展。@已安装- 显示已安装的扩展。@流行- 显示热门扩展。@最近发布- 显示最近在市场中发布的扩展。@推荐- 显示推荐的扩展。按工作区特定或通用分组。@更新- 显示已安装的过期扩展。在市场中提供更新版本。@工作区不支持- 显示此工作区不支持的扩展。@类别- 显示属于指定类别的扩展。以下是支持的几种类别。要查看完整的列表,请输入@类别并按照建议列表中的选项进行操作:@类别:主题@类别:格式化器@类别:静态代码分析工具@类别:片段
这些过滤器也可以组合使用。例如:使用@已安装 @类别:主题查看所有已安装的主题。
如果没有提供过滤器,扩展视图将显示当前已安装和推荐的扩展。
排序
你可以按字母顺序排序扩展。@排序过滤器,可以取以下值:
安装- 按照市场安装数量降序排序。名字- 按扩展名字母顺序排序。发布日期- 按照扩展发布日期排序。评分- 按照市场评分(1-5星)降序排列。更新日期- 按照扩展名、最后更新时间、名称排序。

分类和标签
扩展可以设置类别和Tab来描述其功能。

您可以通过使用来按类别和标签筛选类别:和标签:输入:.
支持的类别有:[Azure, 数据科学, 调试器, 教育, 扩展包, 格式化器, 键盘映射, 语言包, 代码检查器, 机器学习, 笔记本, 其他, 编程语言, 版本控制提供程序, 代码片段, 测试, 主题, 可视化]它们可以通过扩展搜索框中的IntelliSense访问:

请注意,如果类别名称超过一个单词,则必须用引号将其括起来(例如,类别:“SCM 提供者”)。
标签可能包含任何字符串,并且不是由IntelliSense提供的,因此请查看Marketplace以找到有用的标签。
从 VSIX 安装
您可以手动安装一个用 包装的 VS Code 扩展.vsix 文件。使用 从 VSIX 安装 命令在扩展视图命令下拉菜单中,或者在 扩展:从 VSIX 安装 命令在 命令面板 中,指向 .vsix文件。
你也可以使用 VS Code 安装--安装扩展命令行开关提供路径到.vsix文件。
代码 --安装扩展 myextension.vsix
您可以提供--安装扩展在命令行中多次输入以一次安装多个扩展。
当你通过VSIX安装一个扩展时,该扩展的自动更新默认是禁用的。
如果您想了解更多有关包装和发布扩展的信息,请参阅我们的发布扩展文章在扩展 API 中。
工作区推荐的扩展
一组好的扩展可以提高在特定工作区或编程语言下工作的生产力,你通常希望与你的团队或同事分享这个列表。你可以使用扩展:配置推荐扩展(工作区文件夹)命令为工作区创建一个推荐的扩展列表。
在一个单一文件夹的工作区中,该命令创建一个extensions.json文件位于工作区.vscode文件夹,您可以在其中添加扩展标识符列表({publisherName}.{extensionName})。
在一个多根工作区中,该命令将打开你的代码工作区文件,您可以在其中列出扩展名扩展.推荐。您仍然可以通过使用 扩展:配置推荐扩展(工作区文件夹) 命令向多根工作区中的个别文件夹添加扩展推荐。
一个例子extensions.json可能是:
{
"推荐": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]
}
推荐一个代码检查扩展和一个代码格式化扩展。
扩展使用其发布者标识符和扩展标识符进行识别发布者.扩展你可以在扩展的详细页面上看到名称。VS Code 将在这些文件中为您提供已安装扩展的自动完成。
输入:.
VS Code 在首次打开工作区时会提示用户安装推荐的扩展。用户也可以通过扩展:显示推荐的扩展命令查看该列表。

下一步
以下是一些您可能会感兴趣的的话题...
常见问题
扩展程序安装在哪里?
扩展程序安装在每个用户的扩展程序文件夹中。根据您的平台,位置在以下文件夹中:
- Windows
%USERPROFILE%\.vscode\extensions - macOS
~/.vscode/扩展 - Linux
~/.vscode/扩展
您可以通过启动 VS Code 来更改位置--extensions-dir 命令行 选项.
或者,您可以设置VSCODE_扩展将环境变量设置到您希望安装扩展的位置。这在企业环境中非常有用,因为您希望在用户机器上集中管理扩展的安装位置。
每当我尝试安装任何扩展时,我都会收到一个连接ETIMEDOUT错误。
如果您通过代理服务器访问互联网,可能会看到此错误。 请参阅代理服务器支持部分以获取详细信息。
我可以直接从市场下载扩展吗?
一些用户喜欢从Marketplace下载一个扩展,然后将其安装到多个VS Code实例上,通过本地共享。这在存在连接问题或您的开发团队希望使用一组固定扩展时非常有用。
要下载扩展,请在扩展视图中搜索它,右键单击搜索结果中的扩展,然后选择下载 VSIX或下载特定版本的 VSIX。
我可以阻止 VS Code 提供扩展推荐吗?
是的,如果您不希望 VS Code 在扩展视图或通知中显示扩展推荐,您可以修改以下设置:
- extensions.仅在需求时显示推荐- 设置为 true 以移除 推荐 部分。
- 扩展程序.忽略建议- 设置为真以静音扩展推荐通知。
显示推荐扩展命令始终可用,如果您想查看推荐。
我能信任来自市场上的扩展吗?
Visual Studio Marketplace采取了多项措施来保护您免受恶意扩展的侵害,您还可以在安装扩展之前执行各种步骤来确定扩展是否可靠。
截至 VS Code 1.97 版本,当您首次从第三方出版商安装扩展时,VS Code 会显示一个对话框,提示您确认是否信任该扩展出版商。
获取更多信息关于扩展运行时安全.
我可以为我的组织内部托管扩展吗?
是的,参见扩展的私人市场。
扩展签名无法通过 VS Code 验证
Visual Studio Marketplace在发布时对所有扩展进行签名。当您安装扩展时,VS Code会验证此签名以检查扩展包的完整性和来源。
当您安装一个扩展时,您可能会看到以下错误消息:无法安装扩展,因为Visual Studio Code无法验证扩展签名此错误可能由多种原因导致,如果您遇到此错误,请在决定是否继续安装之前谨慎操作。使用以下命令禁用扩展签名验证
包装完整性问题
对于包完整性问题,建议您联系Visual Studio Marketplace团队报告该问题。请确保包括扩展ID。以下列表提供了与包完整性问题相关的错误代码:
包完整性检查失败
签名无效
签名清单无效
签名完整性检查失败
条目缺失
条目被篡改
不可信
证书被吊销
签名无效
签名档案条目过多
未签名
其他问题
对于不支持的环境或未知原因等问题,建议您报告问题,并提供所有必要的信息和包含共享日志:⇧⌘P(Windows, Linux Ctrl+Shift+P) > 打开视图... > 共享。
我的扩展在连接到远程Windows时不会同步
设置同步 可以让你在不同的机器上共享你的 Visual Studio Code 配置,如设置、键盘快捷键和已安装的扩展,这样你总能使用你最喜欢的设置。
VS Code 不会将你的扩展同步到或从 远程 Windows,例如当你连接到 SSH、开发容器 (devcontainer) 或 WSL 时。
我可以在我的组织中允许或阻止特定的扩展吗?
您可以通过配置来控制哪些扩展可以在您的组织中安装扩展允许应用设置。如果未配置该设置,将允许所有扩展。如果已配置该设置,未列出的所有扩展将被阻止安装。
获取更多关于配置允许的扩展名的详细信息。