VS Code 工作区推荐插件配置：从扩展面板到 extensions.json 团队提示

团队项目里常见一个问题：新成员刚拉下代码，格式化、代码检查、语言插件都要自己猜着装。VS Code 的工作区推荐插件可以把这件事固定到项目里：维护者在项目根目录生成 .vscode/extensions.json，团队成员打开项目后，就能在扩展面板里看到推荐安装列表。

本文以 VS Code 桌面版为例，演示从扩展面板添加推荐插件、检查 JSON 文件、让团队成员看到提示、排查没有提示的常见原因。目标结果是：项目根目录出现 .vscode/extensions.json，扩展面板的推荐区能展示项目需要的插件。

准备条件和最终效果

准备一个已经用 VS Code 打开的项目文件夹，并确保左侧活动栏能看到 Extensions 扩展图标。本文以一个前端或后端项目为例，推荐插件可以换成你们团队实际需要的语言、格式化、检查或测试工具。

最终效果不是“所有人自动安装插件”，而是项目明确告诉 VS Code：打开这个工作区时，哪些插件应该被推荐。团队成员仍然可以按需安装、禁用或忽略。

步骤一：打开项目和扩展面板

先用 VS Code 打开项目根目录。确认左侧 Explorer 中能看到源码目录、配置文件和项目根级文件。接着点击左侧活动栏的 Extensions 图标，或使用顶部菜单 View 进入 Extensions。此时右侧主区域会显示扩展搜索框，下面通常有已安装插件、推荐插件和搜索结果。

在扩展面板里搜索团队必须使用的插件，例如代码格式化插件、语言支持插件或检查插件。进入某个插件详情页后，注意插件名称、发布者和插件 ID。后面写入 extensions.json 的正是插件 ID，不是插件展示名。

步骤二：把常用插件加入工作区推荐

在插件详情页右侧或齿轮菜单中，可以找到与工作区推荐相关的操作。推荐做法是先挑选最少必要插件，不要把个人偏好的主题、图标包、快捷键插件放进去。团队推荐列表应该服务项目运行和代码质量，而不是替成员决定编辑器外观。

如果你更习惯直接编辑文件，也可以在项目根目录创建 .vscode/extensions.json。常用结构如下：

{
  "recommendations": [
    "dbaeumer.vscode-eslint",
    "esbenp.prettier-vscode",
    "golang.go"
  ],
  "unwantedRecommendations": [
    "example.old-plugin"
  ]
}

recommendations 表示建议安装的插件，unwantedRecommendations 表示不建议在这个项目里使用的插件。第二项不是必填，只有团队确实要避开某类插件时再使用。

步骤三：检查 extensions.json 文件内容

保存文件后，回到 Explorer，展开 .vscode 文件夹，确认 extensions.json 位于项目根目录下，而不是用户主目录或其他子目录。这个位置非常关键：VS Code 只会按当前工作区读取推荐配置。

然后检查三件事：

1. JSON 格式没有多余逗号，保存后编辑器没有红色错误提示。
2. 插件 ID 使用 publisher.name 形式，而不是插件中文名或展示名。
3. .vscode/extensions.json 已经加入版本管理，团队成员拉取代码后能拿到同一份文件。

步骤四：团队成员如何确认推荐提示

团队成员打开项目后，进入 Extensions 面板，通常可以看到与工作区相关的推荐区。如果某个推荐插件未安装，VS Code 会提供安装入口。成员安装后，插件状态会从推荐变成已安装，相关语言服务、格式化或检查能力才会在项目里生效。

建议团队在项目 README 中补一句：“本项目使用 VS Code 推荐插件，打开项目后请检查 Extensions 面板的 Workspace Recommendations。”这样即使成员错过首次提示，也知道去哪里确认。

常见问题和处理方式

最终确认清单

• 项目根目录存在 .vscode/extensions.json。
• recommendations 中只放项目必需或强相关插件。
• 插件 ID 使用扩展市场中的准确标识。
• 文件已提交到版本管理，团队成员能拉取到。
• 新成员打开项目后，能在 Extensions 面板看到工作区推荐。

总结一下，VS Code 工作区推荐插件适合解决“项目需要哪些编辑器能力”这个问题。把推荐列表写进 .vscode/extensions.json 后，团队成员不必靠口头说明逐个查找插件，项目也能保持更一致的开发体验。