企业官网建设流程全解析

• 文档
• 教程

Visual Studio Code（VS Code）的扩展（Extension）体系是其生态的核心：通过扩展可以为编辑器添加新的编程语言支持、调试器、代码工具以及各种工作流能力。本文以 VS Code 官方文档为基础，系统讲解在 VS Code 中浏览 Marketplace 扩展、安装与卸载扩展、管理扩展设置与自动更新、通过命令行批量管理扩展，以及利用 Profiles、Settings Sync 和企业策略对扩展进行精细化治理的完整方案。读完本文，你将掌握从"搜索安装"到"企业级管控"的扩展全生命周期操作能力。

扩展是什么：为你的工作流添加语言、调试器与工具

VS Code 扩展可以向你的安装添加语言、调试器和工具，以支持你的开发工作流。当你使用 VS Code 时，可以直接从 Visual Studio Marketplace 安装扩展，并利用自动更新功能始终获得最新特性。本仓库对应的官方文档位于 docs/configure/extensions/extensions.md，同目录下还包含扩展市场详解 docs/configure/extensions/extension-marketplace.md 与扩展运行时安全说明 docs/configure/extensions/extension-runtime-security.md。

Visual Studio Marketplace 托管着横跨众多类别的数千个扩展。为了保护你免受恶意扩展的侵害，Marketplace 采用了多种机制，例如发布者信任（Publisher Trust）、恶意软件扫描等，具体可参考 扩展运行时安全 一文。

浏览扩展：使用 Extensions 视图

Extensions 视图（扩展视图）让你能够在 VS Code 内部直接浏览并安装来自 Visual Studio Marketplace 的扩展。

要在 VS Code 内浏览扩展市场：

1. 通过点击**活动栏（Activity Bar）**中的扩展图标打开 Extensions 视图，或使用kb(workbench.view.extensions)键盘快捷键。

2. 可选：使用顶部的搜索框搜索扩展，或使用过滤器按扩展类别等条件筛选。
3. 选中某个扩展即可查看其详情，例如扩展描述、发布者、安装量、用户评分等信息。

扩展视图默认展示当前已安装的扩展以及推荐给你的扩展。每条扩展列表项都包含简短描述、发布者、下载量和五星评分。选中扩展项会打开其详情页，其中可以看到：

• 功能贡献（Feature Contributions）：扩展对 VS Code 的增强，如设置、命令、键盘快捷键、语言语法与调试器；
• 更新日志（Changelog）：扩展仓库的 CHANGELOG（如有）；
• 依赖项（Dependencies）：扩展是否依赖其他扩展。

如果扩展是扩展包（Extension Pack），详情页的Extension Pack区域会显示安装该包时一同安装的扩展列表。扩展包通过 extension-manifest.md 中的机制把多个扩展捆绑在一起，便于一次性批量安装。

安装扩展

你可以直接从 Extensions 视图安装扩展，也可以从 Visual Studio Marketplace 网站安装。

1. 打开 Extensions 视图（kb(workbench.view.extensions)）。
2. 点击扩展卡片上的Install按钮。

3. 你也可以在扩展详情页上选择Install按钮。

安装完成后，Install按钮会变为Manage齿轮按钮。除此之外，你还可以：

• 安装特定版本：右键点击扩展并选择Install Another Version，从可用版本列表中选择。
• 安装预发布版本（Pre-Release）：部分扩展发布者会提供预发布版本，点击Install按钮上的下拉箭头并选择Install Pre-Release Version。
• 从 VSIX 安装：在 Extensions 视图命令下拉菜单中选择Install from VSIX，或在命令面板中执行Extensions: Install from VSIX，然后选择.vsix文件。通过 VSIX 安装的扩展默认关闭自动更新。
• 不同步安装（Do not Sync）：开启 Settings Sync 后，右键扩展选择Install (Do not Sync)，即可在本地安装但不跨机器同步。

提示：如果你需要在不同技术栈之间切换，建议使用 VS Code Profiles：例如在一个 Profile 中安装 Web 开发扩展，在另一个 Profile 中安装数据科学扩展，从而只为特定工作负载安装所需扩展。Profile 是对扩展、设置、快捷键等配置的整套快照，可在不同项目/工作区之间快速切换。

扩展的信任提示

重要：扩展与 VS Code 本身拥有相同的权限。自 VS Code 1.97 起，当你首次从第三方发布者安装扩展时，VS Code 会弹出一个对话框，要求你确认信任该扩展的发布者。更多信息参见 扩展运行时安全 以及如何防范恶意扩展。

一次安装多个扩展

在命令行中，你可以多次提供--install-extension参数以一次安装多个扩展：

code --install-extension ms-python.python --install-extension dbaeumer.vscode-eslint

打开扩展设置：扩展贡献的设置项

扩展可以向 VS Code 贡献（contribute）设置。使用 Settings 编辑器 可以像查看 VS Code 其他设置一样查看和修改这些扩展设置：

1. 通过文件>首选项>设置菜单打开 Settings 编辑器，或使用kb(workbench.action.openSettings)键盘快捷键。
2. 在设置树视图中选择扩展（Extensions），然后选择具体的扩展以查看其设置。

从扩展管理的角度看，以下几个内置设置直接控制扩展行为，可在 Settings 编辑器中搜索配置：

• extensions.autoUpdate：是否自动更新扩展（默认开启）。
• extensions.autoUpdateDelay：扩展发布后延迟自动更新的时间（单位小时，默认12）。设为0表示发布后立即安装；该延迟仅在自动更新开启时生效。若想立即更新某个扩展，直接点击其Update按钮即可绕过延迟。
• extensions.autoCheckUpdates：设为false可让 VS Code 完全不检查扩展更新。
• extensions.ignoreRecommendations：设为true可停止扩展推荐通知。
• extensions.verifySignature：用于关闭扩展签名验证（需谨慎使用，见下文"签名验证"一节）。
• extensions.allowed：企业场景下控制允许安装的扩展列表（自 VS Code 1.96 起支持），详情见 docs/enterprise/extensions.md。

卸载与禁用扩展

你可以从 Extensions 视图中卸载扩展。如果只是想临时停用，建议选择禁用而非卸载：

1. 打开 Extensions 视图（kb(workbench.view.extensions)）。
2. 点击扩展卡片上的齿轮图标或右键点击扩展卡片，然后选择Uninstall。

卸载或禁用扩展后，VS Code 会提示你**重启扩展宿主（Restart Extensions）**以生效。

禁用与启用

• 禁用：点击扩展条目右侧的齿轮按钮，可选择全局禁用或仅对当前工作区禁用（Disable (Workspace)）。禁用后扩展会保留在Disabled分区并标记为Disabled，且在所有 VS Code 会话中保持禁用，直到你重新启用。
• 批量禁用：命令面板或扩展视图More Actions（...）菜单中的Disable All Installed Extensions命令可以快速禁用全部已安装扩展。
• 重新启用：在扩展的Manage菜单中选择Enable或Enable (Workspace)；More Actions菜单中还提供Enable All Extensions命令。

自动更新与手动更新

VS Code 会检查扩展更新并自动安装，更新后提示重启扩展宿主。相关操作：

• 使用Disable Auto Update for Extensions命令（或扩展视图中对应操作）关闭自动更新，使用Enable Auto Update for Extensions命令重新开启；也可以直接配置extensions.autoUpdate设置。
• 自动更新开启时，VS Code 只更新已启用的扩展；被禁用的扩展不会自动更新，会在下次启用时更新。
• 可针对单个扩展右键切换Auto Update开关。
• 关闭自动更新后，用Show Extension Updates命令（对应@updates过滤器）快速查看可用更新；点击过时扩展的Update按钮立即更新，或用Update All Extensions命令一次性更新所有过时扩展。
• 若连自动检查也关闭了，可用Check for Extension Updates命令手动检查。

扩展视图过滤器与排序：高效查找与管理

扩展视图的搜索框支持过滤器语法，输入@即可看到全部过滤器与排序命令的补全建议，也可通过Filter Extensions上下文菜单打开过滤器列表。

常用过滤器：

过滤器可以组合使用，例如@installed @category:themes查看所有已安装的主题。若未提供任何过滤器，扩展视图默认显示已安装与推荐的扩展。

排序使用@sort过滤器，可取以下值：

• installs：按 Marketplace 安装量降序；
• name：按扩展名称字母序；
• publishedDate：按发布时间；
• rating：按评分（1–5 星）降序；
• updateDate：按最近更新时间。

此外，扩展还可以设置Categories与Tags来描述功能。支持category:与tag:筛选；类别名称含多个单词时需加引号，例如category:"SCM Providers"。支持类别包括：AI, Azure, Chat, Data Science, Debuggers, Extension Packs, Education, Formatters, Keymaps, Language Packs, Linters, Machine Learning, Notebooks, Programming Languages, SCM Providers, Snippets, Testing, Themes, Visualization, Other。标签可包含任意字符串，不提供智能补全，需要查看 Marketplace 获取有用的标签。

如果你知道扩展的精确标识符，还可以使用@id:前缀精确定位，例如@id:vue.volar。

推荐扩展与工作区扩展推荐

使用Show Recommended Extensions（对应@recommended过滤器）可以查看推荐扩展列表。推荐来源有两类：

• 工作区推荐（Workspace Recommendations）：由当前工作区的其他用户推荐；
• 其他推荐（Other Recommendations）：根据最近打开的文件推荐。

忽略某个推荐

打开扩展详情页，点击Manage齿轮按钮显示上下文菜单，选择Ignore Recommendation。被忽略的推荐不再出现。

为团队创建工作区推荐列表

一个精心挑选的扩展集能显著提升特定工作区或语言的开发效率，你可以通过Extensions: Configure Recommended Extensions (Workspace Folder)命令为工作区创建推荐列表：

• 在单文件夹工作区中，该命令会在工作区的.vscode文件夹下创建extensions.json，在其中按publisher.extension形式列出扩展标识符；
• 在多根工作区中，该命令会打开.code-workspace文件，你可以在其中通过extensions.recommendations列出扩展；仍可使用上述命令为多根工作区中的单个文件夹添加推荐。

例如，一个extensions.json文件可以包含：

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

该示例推荐了一个 linter 扩展和一个代码格式化扩展。扩展使用publisher.extension格式标识，VS Code 会为已安装扩展提供自动补全。首次打开工作区时，VS Code 会提示用户安装推荐的扩展；用户也可以随时用Extensions: Show Recommended Extensions命令查看列表。

扩展的配置方式

扩展的配置形态差异很大：有些扩展向 VS Code 贡献设置，可在 Settings 编辑器中修改；有些扩展拥有自己的配置文件；还有些扩展需要额外安装编译器、调试器或命令行工具等组件。请查阅扩展 README（在扩展视图详情页可见），或在详情页点击扩展名称跳转到其 Marketplace 页面；很多扩展是开源的，其 Marketplace 页面提供源码仓库链接。

命令行管理扩展：自动化与脚本化

为了更方便地自动化与配置 VS Code，可以从命令行列出、安装、卸载扩展。识别扩展时请提供完整的publisher.extension形式名称，例如ms-python.python。

常用命令：

code --list-extensions # 列出已安装扩展 code --list-extensions --show-versions # 同时显示每个扩展的版本 code --install-extension ms-python.python # 按 ID 安装扩展 code --uninstall-extension ms-python.python # 按 ID 卸载扩展 code --extensions-dir <directory> # 设置扩展根目录 code --install-extension myextension.vsix # 从 VSIX 文件安装 code --install-extension vscode.csharp@1.2.3 # 安装指定版本（@version 后缀）

扩展 ID 可以在扩展详情页的 Marketplace Info 区域查看。更多命令行选项：

• --install-extension <extension-id> | <extension-vsix-path>：安装或更新扩展，支持@版本号指定版本；--force参数可避免提示；--profile参数可为特定 Profile 安装。
• --uninstall-extension <extension-id>：卸载扩展。
• --disable-extensions：禁用所有已安装扩展（扩展仍显示在 Disabled 分区但不会被激活）。
• --list-extensions/--show-versions：列出扩展及版本。
• --update-extensions：更新已安装扩展并退出。
• --enable-proposed-api <ext>：为扩展启用 Proposed API 功能。

扩展安装位置与常见问题

扩展安装在哪里？

扩展安装到每个用户的扩展文件夹中，按平台不同位置如下：

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

可以通过--extensions-dir <dir>命令行选项更改位置（在便携模式下会被data文件夹覆盖）。或者设置VSCODE_EXTENSIONS环境变量指定安装位置——这在需要集中管理用户机器扩展安装位置的企业环境中非常有用。

安装扩展时出现 ETIMEDOUT 错误

如果机器通过代理服务器访问互联网，可能会遇到此错误，参见 设置主题中的代理服务器支持 一节。

可以直接从 Marketplace 下载扩展吗？

可以。在扩展视图搜索扩展，右键结果并选择Download VSIX或Download Specific Version VSIX，即可下载一次 VSIX，再通过本地共享安装到多个 VS Code 实例——这适用于网络受限或团队需要固定扩展集的情况。

能信任 Marketplace 中的扩展吗？

Marketplace 采取多种措施防范恶意扩展，你也可以在安装前自行评估扩展的可靠性，详见 扩展运行时安全。该文档详细说明了 VS Code 如何在安装前确认你信任扩展的发布者，以及如何保护自己免受恶意扩展侵害。

组织内可以私有托管扩展吗？

可以。参见 企业扩展管理 中"托管私有扩展市场（Private Marketplace for Extensions）"一节。私有市场支持自托管内部扩展、从公共 Marketplace 自动上游（Upstreaming）公共扩展、在气隙环境中重新托管公共扩展，并可直接在 VS Code 扩展视图中完成搜索与自动更新。

扩展签名无法验证

Marketplace 在扩展发布时会为所有扩展签名，VS Code 在安装时验证签名以检查扩展包的完整性与来源。如果遇到错误消息Cannot install extension because VS Code cannot verify the extension signature，可能由多种原因导致。遇到该错误时，请谨慎决定是否继续安装；可通过extensions.verifySignature设置关闭签名验证（不推荐）。

与包完整性相关的问题可以联系 Marketplace 团队，并提供扩展 ID。常见错误码包括：

PackageIntegrityCheckFailed SignatureIsInvalid SignatureManifestIsInvalid SignatureIntegrityCheckFailed EntryIsMissing EntryIsTampered Untrusted CertificateRevoked SignatureIsNotValid SignatureArchiveHasTooManyEntries NotSigned

对于不支持的环境或未知原因等其他问题，可向 VS Code 提交 issue 并附上共享日志。

远程窗口（Remote Window）下扩展不同步？

Settings Sync 可以跨机器共享设置、快捷键和已安装扩展。但 VS Code不会在远程窗口之间同步扩展，例如通过 SSH、开发容器（devcontainer）或 WSL 连接时。

组织内如何允许或阻止特定扩展？

通过配置extensions.allowed应用级设置控制。未配置时允许所有扩展；配置后，未列出的扩展将被阻止安装。可以按发布者（如"microsoft": true）、按具体扩展（如"esbenp.prettier-vscode": true）、按版本与平台（如"rust-lang.rust-analyzer": ["5.0.0@win32-x64"]）或按稳定版（"stable"）进行精细管控；更具体的选择器优先级更高，"*"可通配允许或阻止所有扩展，例如"*": false阻止全部扩展。组织还可以通过AllowedExtensions企业策略集中部署，覆盖用户本地的配置，详见 docs/enterprise/extensions.md 与 企业策略参考。

扩展安全：运行时权限与发布者信任

了解扩展的权限模型有助于你做出更安全的安装决策：

• 运行时权限：扩展由扩展宿主（Extension Host）负责运行，扩展宿主与 VS Code 本身拥有相同权限。这意味着 VS Code 能执行的任何操作——读写机器上的文件、发起网络请求、运行外部进程、修改工作区设置——扩展都能通过扩展宿主执行。
• 发布者信任：自 VS Code 1.97 起，首次安装第三方发布者的扩展时会弹出对话框确认是否信任该发布者；信任扩展包或带依赖的扩展时，同时信任其依赖扩展的发布者；之前安装过的发布者视为已信任并自动加入信任列表；可通过Extensions: Manage Trusted Extensions Publishers命令管理信任列表。
• 可靠性评估指标：在安装前可以参考 Marketplace 提供的评级与评论（Ratings & Reviews）、问答（Q & A）、Issues/仓库/许可证信息，以及已验证发布者（蓝色对勾标识，代表发布者已向 Marketplace 证明域名所有权，且 Marketplace 已核实域名存在并确认发布者良好信誉至少六个月）。
• Marketplace 防护机制：包括多引擎恶意软件扫描、沙箱（clean room VM）中的动态行为检测、已验证发布者、异常使用模式监控、名称抢注（Name squatting）拦截、恶意扩展阻止列表（Block List，已安装的恶意扩展会被自动卸载）、扩展签名验证，以及自动扫描新发布扩展中的密钥/凭据（Secret Scanning）。

如果发现可疑扩展，可以在其 Marketplace 页面底部的More Info区域选择Report a concern向 Marketplace 团队举报，团队会在一个工作日内给出初步响应。

下一步

• 扩展市场：了解更多关于推荐扩展、预发布扩展、命令行安装扩展的细节；
• 扩展运行时安全：了解 VS Code 如何保护你免受恶意扩展侵害；
• VS Code 扩展开发：如果市场中没有你需要的扩展，可创建并发布自己的扩展，打包发布细节见 发布扩展；
• VS Code 快速上手：通过分步指南探索 VS Code 的核心功能；
• 版本控制：了解如何在 VS Code 中配置基于 Git 的版本控制；
• 调试：为你的项目配置调试；
• 个人化 VS Code：通过主题、图标、快捷键与显示语言进一步个性化编辑器，其中语言包（Language Pack）也是以扩展形式安装的。

• 文档
• 教程