VSCode 的“工作区推荐插件”通过 .vscode/extensions.json 的 recommendations 字段声明扩展 ID 数组，打开工作区时显示横幅提示安装；还支持 unwantedRecommendations 等字段，与 settings.json（配置）、devcontainer.json（运行环境）职责分离，需准确填写 ID 并纳入版本控制。

VSCode 的“工作区推荐插件”功能，是通过 .vscode/extensions.json 文件，为特定项目（工作区）显式声明一组建议安装的扩展，帮助团队成员或新协作者快速配置一致的开发环境。

如何启用并配置推荐插件

在项目根目录下的 .vscode/extensions.json 文件中，写入一个 JSON 对象，包含 recommendations 字段，值为扩展 ID 数组。扩展 ID 格式为 publisher.name（例如 esbenp.prettier-vscode）。

• 文件路径必须是 .vscode/extensions.json，不能放在其他位置
• VSCode 会在打开该工作区时自动检测，并在 Extensions 视图顶部显示“Recommended Extensions”横幅
• 用户点击“Install All”即可一键安装全部推荐插件

支持的字段不止 recommendations

除了基础的 recommendations，extensions.json 还支持：

• unwantedRecommendations：明确排除某些插件（避免误推）
• workspaceDependencies：声明工作区级依赖（如需要特定版本的 TypeScript 插件）
• webRecommendations：仅对 Web 容器环境（如 GitHub Codespaces、Dev Containers）生效的推荐

和 settings.json、devcontainer.json 的区别

这个功能专注“谁该装什么”，不涉及配置或运行环境：

• settings.json 管的是“怎么用”（比如 Prettier 默认格式化工具）
• devcontainer.json 管的是“在哪跑”（容器镜像、端口、预装命令等）
• extensions.json 只管“装哪些插件”，轻量、独立、可版本控制

实际使用小提醒

推荐插件不会自动安装，也不会覆盖用户已禁用的插件。它只是提示——这点很关键：

• 团队协作时，把它纳入 Git 提交，新人克隆即得推荐清单
• 插件 ID 必须准确；拼错或过时 ID 会导致推荐失效（可在 VSCode 扩展市场页面 URL 中找到标准 ID）
• 如果项目用了 Dev Container，建议同时在 devcontainer.json 的 customizations.vscode.recommendedExtensions 中也列一遍，确保容器内也触发提示

基本上就这些。它不复杂，但容易忽略——尤其在多人维护的项目里，一条清晰的 extensions.json 能省下不少“你装了 XXX 吗”的沟通成本。