工作区设置不生效需检查.vscode/settings.json是否被覆盖；VSCode多项目工作区中设置优先级为：用户设置＜工作区设置＜文件夹设置。
工作区设置不生效？检查 .vscode/settings.json 是否被覆盖
vscode 多项目工作区（.code-workspace）中，设置优先级是：用户设置 .code-workspace 文件里可以内嵌 "settings" 字段，它会**直接覆盖**各文件夹下的 .vscode/settings.json。
如果你发现某个文件夹里的 .vscode/settings.json 明明写了 "editor.tabSize": 2，但打开后还是 4，大概率是 .code-workspace 里写了同名配置：
{
"folders": [{ "path": "backend" }, { "path": "frontend" }],
"settings": {
"editor.tabSize": 4
}
}
解决办法很简单：
- 要么删掉
.code-workspace中的"settings"段，让子文件夹设置接管 - 要么把需要差异化配置的项（比如 ESLint 路径、Python 解释器）挪到对应文件夹的
.vscode/settings.json中，并确保.code-workspace不重写它们 - 用命令面板运行
Preferences: Open Workspace Settings (JSON)，确认当前生效的是哪一层设置
加载失败提示 “Failed to load workspace”？核对 folders 路径是否为相对路径或绝对路径混用
VSCode 要求 .code-workspace 中的 "path" 必须是相对于该文件本身的路径，或绝对路径——但不能在同一个文件里混用两种写法，否则可能静默失败或只加载部分文件夹。
常见错误示例：
{
"folders": [
{ "path": "server" },
{ "path": "/Users/me/client" }
]
}
这个配置在某些系统（尤其是 Windows + WSL 联用场景）下会导致 client 文件夹不显示、终端打不开、扩展不激活。正确做法是统一风格：
- 全用相对路径（推荐）：
"path": "server"和"path": "client"，前提是.code-workspace放在两个文件夹的共同父目录下 - 全用绝对路径（跨磁盘/远程时必需）：
"path": "/home/user/project/server"和"path": "/home/user/project/client" - 路径末尾不要加
/，VSCode 不识别"path": "server/"
Python / Node.js 环境没识别？别只依赖 python.defaultInterpreterPath
多项目工作区里，不同文件夹可能用不同 Python 版本或 Node 版本。仅靠 .code-workspace 设置全局 python.defaultInterpreterPath 是无效的——它不会按文件夹切换解释器。
真正起作用的是每个文件夹下的 .vscode/settings.json：
// backend/.vscode/settings.json
{
"python.defaultInterpreterPath": "./venv/bin/python"
}
// frontend/.vscode/settings.json
{
"python.defaultInterpreterPath": "../shared-venv/bin/python",
"npm.packageManager": "pnpm"
}
注意点：
-
python.defaultInterpreterPath的值必须是**存在且可执行**的路径，VSCode 不做容错校验，填错就当没设 - Node 相关设置（如
npm.packageManager）同样只在文件夹级生效，工作区级设置会被忽略 - 如果用了 Pylance 或 TypeScript Server，还要确认
python.analysis.extraPaths或typescript.preferences.includePackageJsonAutoImports是否按需配在对应文件夹里
扩展未激活或功能异常？检查 "extensions" 字段是否误删了 recommendations
VSCode 工作区可声明推荐扩展（extensions.recommendations），但它不是自动安装列表，也不会强制启用。很多人以为加了 "extensions": { "recommendations": ["ms-python.python"] } 就能保证 Python 扩展可用，其实这只是个提示。
真正影响扩展行为的是：
- 扩展是否已全局安装（
Extensions: Show Installed Extensions） - 该扩展是否支持“工作区启用”（例如
esbenp.prettier-vscode默认只在有.prettierrc的文件夹激活） -
.code-workspace中若手动写了"extensions": { "unwantedRecommendations": [...] }，可能意外屏蔽了关键扩展
建议做法：
在每个文件夹的 .vscode/extensions.json 里显式声明必需扩展（VSCode 1.85+ 支持）：
// backend/.vscode/extensions.json
{
"recommendations": ["ms-python.python", "ms-toolsai.jupyter"]
}
然后提醒团队成员运行 Extensions: Install Recommended Extensions —— 这步手动触发不可跳过。
多项目工作区真正的复杂点不在配置语法，而在于「哪一层配置管哪件事」的边界模糊。尤其当文件夹结构嵌套、路径跨卷、扩展依赖版本时，一个看似无关的 settings.json 位置偏差，就足以让调试器连不上、格式化失效、甚至 Git 面板空白。动手前先用 Developer: Toggle Developer Tools 看控制台有没有 Failed to resolve configuration 类报错，比反复重启更省时间。
