VSCode不主动检测项目类型，而是依赖标志性文件（如package.json、pyproject.toml）、已安装对应语言扩展及工作区配置（.vscode/settings.json）被动响应；多语言冲突需下沉配置至工作区，禁用全局语言相关设置。
为什么打开项目后右下角没弹“Install recommended extensions”
这通常说明 .vscode/extensions.json 根本不存在，或者 VSCode 没读到它：
- 检查项目根目录下是否有
.vscode/extensions.json，且格式合法（仅含{"recommendations": [...]}） - 确保该文件没被
.gitignore或编辑器设置隐藏（比如设置了"files.exclude": {".vscode": true}） - 如果项目是通过
.code-workspace文件打开的，VSCode 默认不加载该 workspace 下的.vscode/extensions.json，必须把推荐列表显式写进.code-workspace的"extensions"字段里 - 用户级设置中若禁用了推荐（
extensions.ignoreRecommendations设为true），工作区推荐也会被压制
package.json 和 pyproject.toml 同时存在，为什么 Python 扩展总抢着激活
VSCode 不做“项目类型仲裁”，它按文件打开顺序和语言模式缓存决定谁先上。常见表现是：你上次点开的是 main.py，这次即使先看 package.json，终端默认还是 Python 解释器。
- 真正触发 Python 扩展的是
pyproject.toml+.py文件 + 已安装ms-python.python扩展；Node.js 扩展依赖package.json+ms-vscode.vscode-typescript-next或类似扩展 - 冲突根源常在全局
settings.json：比如写了"python.defaultInterpreterPath": "/usr/bin/python3"，就会让所有项目都尝试加载 Python 服务 - 解法是下沉配置：删掉用户级 settings 里的
python.、typescript.等前缀项，在每个项目根下的.vscode/settings.json中单独写，例如：{"python.defaultInterpreterPath": "./venv/bin/python"} - 混用项目可加
"files.associations": {"*.js": "javascriptreact"}控制单文件语言模式，但这不影响项目级扩展激活逻辑
点了“Install recommended extensions”却没装上指定插件
推荐弹窗只是 UI 提示，背后依赖两个前提：VSCode 能联网访问 Marketplace，且扩展 ID 拼写完全正确（大小写敏感、无空格、带发布者前缀）。
- 常见错误 ID：
prettier（错）→ 正确是esbenp.prettier-vscode；python（错）→ 应为ms-python.python - 某些扩展（如
ms-dotnettools.csharp）需匹配当前系统架构（ARM64/Intel）和 VSCode 版本（如要求 engine >= 1.85.0），旧版 VSCode 可能静默跳过 - 企业环境若配置了代理或禁用了扩展市场（
extensions.autoCheckUpdates关闭 +extensions.autoUpdate关闭），推荐安装会失败且无明确报错 - 安装后不生效？重启 VSCode 窗口（不是重载窗口），因为扩展进程是在窗口启动时加载的
怎么让新成员一打开项目就获得完整开发环境
靠 .vscode/extensions.json + .vscode/settings.json + devcontainer.json 三层配合，缺一不可。
-
extensions.json声明“该装啥”，只列 ID；settings.json声明“怎么用”，比如python.defaultInterpreterPath、editor.formatOnSave - 纯前端项目建议加
"typescript.preferences.allowNonTsExtensions": true，否则.js文件无法享受 TS 类型检查 - 若团队统一用 Dev Container，
devcontainer.json的优先级高于本地 settings，此时.vscode/settings.json里的解释器路径等配置会被忽略，必须写进devcontainer.json的"customizations.vscode.settings"字段 - 最易忽略的一点：VSCode 不会自动创建
.vscode目录。首次提交时，务必确认该目录已 git track，否则新人 clone 后根本看不到任何推荐提示
