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 的区别
这个功能专注“谁该装什么”,不涉及配置或运行环境:
系统介绍:YIXUNCMS中专专版是易迅软件工作室在中秋节来临之即推出的专题模板建站系统,使用增强版后台管控系统,板板设计符合节日特点。易迅软件工作室恭祝全国人民中秋快乐。特别提示:由于网站页面的不同设计,部分后台功能未在前端进行体现。系统特点:1、采用目前流行的PHP语言编写,底层采用超轻量级框架作为系统支撑;2、页面布局使用DIV+CSS技术,遵循WEB标准,及大提高页面的浏览速度;3、使用应
-
settings.json管的是“怎么用”(比如 Prettier 默认格式化工具) -
devcontainer.json管的是“在哪跑”(容器镜像、端口、预装命令等) -
extensions.json只管“装哪些插件”,轻量、独立、可版本控制
实际使用小提醒
推荐插件不会自动安装,也不会覆盖用户已禁用的插件。它只是提示——这点很关键:
- 团队协作时,把它纳入 Git 提交,新人克隆即得推荐清单
- 插件 ID 必须准确;拼错或过时 ID 会导致推荐失效(可在 VSCode 扩展市场页面 URL 中找到标准 ID)
- 如果项目用了 Dev Container,建议同时在
devcontainer.json的customizations.vscode.recommendedExtensions中也列一遍,确保容器内也触发提示
基本上就这些。它不复杂,但容易忽略——尤其在多人维护的项目里,一条清晰的 extensions.json 能省下不少“你装了 XXX 吗”的沟通成本。









