VSCode工作区推荐插件通过.vscode/extensions.json文件定义,支持查看、手动创建、批量安装、单个忽略及基于文件类型的条件推荐。

如果您在使用 VSCode 打开某个项目文件夹时,发现编辑器右下角弹出“Install recommended extensions”提示,或在命令面板中看到“Show Workspace Recommendations”选项,则说明该工作区已定义插件推荐列表。以下是启用、查看与管理这些推荐插件的具体操作方式:
本文运行环境:MacBook Air,macOS Sequoia。
一、查看当前工作区的推荐插件列表
VSCode 通过项目根目录下的 .vscode/extensions.json 文件声明推荐插件,该文件不强制安装,仅作为团队协作时的标准化提示依据。编辑器会自动读取该文件并在 UI 中呈现推荐项。
1、确保项目根目录存在 .vscode 文件夹,且其中包含 extensions.json 文件。
2、打开 VSCode 命令面板(快捷键 Cmd+Shift+P),输入并选择 Extensions: Show Workspace Recommendations。
3、此时侧边栏将展开“Workspace Recommendations”面板,列出所有标记为 Recommended 的扩展及其安装状态。
二、手动创建或编辑 extensions.json 文件
当项目尚未配置推荐插件时,可通过手动创建 extensions.json 文件来定义团队统一开发环境。该文件采用标准 JSON 格式,仅包含 recommendations 字段,值为扩展 ID 数组。
1、在项目根目录下新建文件夹 .vscode(若不存在)。
2、在该文件夹内新建文件,命名为 extensions.json。
3、在文件中写入如下结构:
{
"recommendations": [
"esbenp.prettier-vscode",
"ms-python.python",
"redhat.vscode-yaml"
]
}
4、保存后,VSCode 将立即识别并刷新推荐面板,无需重启编辑器。
三、批量安装工作区推荐插件
VSCode 提供一键安装全部推荐插件的功能,适用于新成员加入项目或重装开发环境的场景。安装行为仅影响当前工作区,不会全局启用插件。
1、点击 VSCode 窗口右下角出现的 Install Recommended Extensions 气泡提示。
2、若气泡未出现,可右键资源管理器中的工作区文件夹名称,选择 Install Recommended Extensions for 'xxx'。
3、在弹出的扩展视图中,勾选全部推荐项左侧的复选框。
4、点击顶部工具栏的 Install 按钮(图标为向下箭头),安装过程将跳过已启用的插件。
四、禁用或忽略某项推荐
某些推荐插件可能与本地开发流程冲突(如 Linter 与已有构建链路重复),此时可选择性忽略单个推荐,而不删除整个 extensions.json 文件。
1、打开“Workspace Recommendations”面板(命令面板 → Extensions: Show Workspace Recommendations)。
2、找到目标插件条目,在其右侧点击三个点图标(⋯)。
3、从下拉菜单中选择 Ignore Recommendation。
4、该插件将从推荐列表中移除显示,且 下次打开工作区时不再提示,原始 extensions.json 内容保持不变。
五、基于文件类型动态推荐插件
VSCode 支持在 extensions.json 中使用条件推荐语法,根据工作区中是否存在特定文件(如 package.json、pyproject.toml)自动激活对应插件建议,提升推荐精准度。
1、编辑 .vscode/extensions.json,将 recommendations 替换为 unwantedRecommendations 和 recommendations 并存结构。
2、添加条件字段 when,例如:
{"recommendations": ["esbenp.prettier-vscode"], "when": "resourceExtname == .js || resourceExtname == .ts"}
3、保存后,VSCode 会根据当前打开的文件类型动态筛选推荐项,仅在匹配条件下显示该推荐。










