必须在项目根目录创建.vscode/extensions.json文件,内容为合法JSON且仅含recommendations字段(如["ms-python.python"]),同时确保extensions.ignoreRecommendations为false,VSCode才会在首次打开时显示“Workspace Recommendations”提示。

项目需要什么功能,就装对应插件——不是“挑好看的装”,而是按需精准安装。VSCode 本身不自动推插件,靠的是人工配置或约定好的文件触发。
怎么让新成员一打开项目就知道该装啥
在项目根目录下建 .vscode/extensions.json,内容必须是合法 JSON:
-
recommendations字段名不能拼错(不是recommends或suggested) - 每个插件 ID 格式为
publisher.name,比如ms-python.python、esbenp.prettier-vscode - 数组里不能有中文逗号、尾随逗号、多余空格,否则整个文件失效
- 路径必须是
.vscode/extensions.json,放错层级(比如放在src/.vscode/)不会被识别
示例正确写法:
{
"recommendations": [
"ms-python.python",
"esbenp.prettier-vscode",
"redhat.vscode-yaml"
]
}
本地开发 vs Remote-SSH 场景插件推荐不生效
VSCode 的 extensions.json 只对本地窗口生效;用 Remote-SSH 连服务器时,这个文件会被忽略。
- Remote 场景要用
devcontainer.json的extensions字段,它会自动在容器里装插件 - 别把调试类插件(如
ms-vscode.cpptools)塞进extensions.json,远程开发时根本不会装 - 如果项目既支持本地又支持 Remote,两个文件都要配:
.vscode/extensions.json+.devcontainer/devcontainer.json - 检查用户是否手动关闭过推荐弹窗(点了「不再显示」),或设置了
"extensions.ignoreRecommendations": true
插件装了但功能没反应?先查这三件事
常见现象:装了 Python 插件,Ctrl+Shift+P 搜不到 Python: Select Interpreter;装了 Prettier,保存不格式化。
- 确认插件已启用:在扩展面板搜插件名,右上角开关是蓝色(不是灰色)
- 检查工作区设置是否覆盖了全局设置,比如
editor.formatOnSave在.vscode/settings.json里被设为false - 某些插件依赖其他插件或语言服务,例如
redhat.vscode-yaml需要文件后缀是.yaml或.yml才激活,不是所有带冒号的文本都算 YAML
最常被忽略的点:插件推荐只在「首次打开该文件夹」时弹横幅;之后再开不会提醒,也不会自动装——得手动点「Install All」,且前提是没关掉推荐开关。


















