VSCode 通过 .vscode/extensions.json 文件推荐插件,格式为 {"recommendations": ["publisherId.extensionName"]},首次打开项目时提示安装,支持一键安装全部推荐扩展。
vscode 可以通过 .vscode/extensions.json 文件为项目推荐插件,让团队成员或新协作者一键安装所需扩展,提升开发环境一致性。
创建 extensions.json 文件
在项目根目录下新建 .vscode 文件夹(如果不存在),再在里面创建 extensions.json 文件。该文件是纯 JSON 格式,用于声明推荐的扩展列表。
- 文件路径必须是
.vscode/extensions.json - 只支持
recommendations字段,值为字符串数组 - 每个字符串是扩展的唯一 ID,格式为
publisherId.extensionName(例如ms-python.python)
填写推荐扩展 ID
扩展 ID 可在 VSCode 扩展市场页面 URL 中找到,例如:
https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode → ID 是 esbenp.prettier-vscode
也可以在已安装扩展的详情页右键“复制扩展 ID”获取。
常见推荐示例:
{
"recommendations": [
"ms-python.python",
"esbenp.prettier-vscode",
"redhat.vscode-yaml",
"editorconfig.editorconfig"
]
}
生效与使用方式
保存后,VSCode 不会自动安装这些插件,但会在以下场景提示用户:
- 首次打开项目时,右下角弹出「推荐扩展」通知
- 命令面板(Ctrl+Shift+P)中执行 Extensions: Show Recommended Extensions for this Workspace
- 扩展视图底部显示「Workspace Recommendations」区域,列出所有推荐项
用户可逐个安装,或点击「Install All」一键安装全部推荐扩展。
进阶技巧
支持条件推荐(需 VSCode 1.82+):
- 用
unwantedRecommendations排除某些不适用的默认推荐 - 配合
extensions.ignoreRecommendations设置可全局禁用推荐提示 - 团队还可搭配
settings.json和tasks.json一起配置统一开发体验










