工作区设置是优先级更高的覆盖层，非隔离开关；需手动创建.vscode/settings.json或通过设置界面添加，确保以文件夹方式打开并显示workspace标签。
工作区设置不是“隔离开关”，而是优先级更高的覆盖层：只要 .vscode/settings.json 存在且位于项目根目录，它就会自动叠加并覆盖同名的用户设置，但仅限该文件夹及其子目录——其他项目完全不受影响。
如何正确创建和触发工作区 settings.json
VSCode 不会自动生成 .vscode/settings.json，必须手动创建或通过设置编辑器添加。直接新建文件容易遗漏格式或路径问题；更稳妥的方式是：
- 确保以「文件夹方式」打开项目（不是单个文件，也不是多根工作区先没保存）
- 按
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开设置界面 - 在搜索框输入目标配置项，例如
python.defaultInterpreterPath - 找到后点击右侧的「文件夹图标」（Folder icon），再选「Add to Workspace Settings」
- VSCode 会自动创建
.vscode/目录并写入settings.json，内容带注释、结构合法
常见错误：用资源管理器右键「在 VSCode 中打开」某个 .js 文件，结果打开的是单文件窗口——此时任何设置操作都只作用于用户级，.vscode 根本不会被识别。
多根工作区（.code-workspace）里的 settings 怎么写
多根工作区不是多个 .vscode/settings.json 的简单合并，而是在 my-project.code-workspace 文件顶层用 settings 字段统一声明，对所有子文件夹生效；若需为某子项目单独设值（如前端用 2 空格、后端用 4），得靠路径条件判断：
-
settings写在.code-workspace文件顶层 JSON 中，适用于整个工作区 - 语言级覆盖可用
"[javascript]": { "editor.tabSize": 2 }这类语法，VSCode 原生支持 - 绝对不要在
.code-workspace里写"python.defaultInterpreterPath": "./server/venv/bin/python"这种相对路径——VSCode 解析时当前工作目录不明确，大概率失效 - 跨子项目调试时，
launch.json应放在对应子文件夹的.vscode/下，而非工作区根目录
示例有效片段：
{
"folders": [
{ "path": "client" },
{ "path": "server" }
],
"settings": {
"editor.formatOnSave": true,
"[json]": { "editor.tabSize": 2 },
"[python]": { "editor.tabSize": 4 }
}
}
哪些配置不该放工作区，哪些必须放
工作区配置不是“什么都能塞”，放错位置反而引发冲突或失效：
- 必须放：项目强依赖的编辑行为，如
eslint.enable、prettier.requireConfig、files.exclude（隐藏**/dist）、editor.codeActionsOnSave - 不该放：个人偏好类设置，如
workbench.colorTheme、editor.fontSize、快捷键绑定（keybindings.json）——这些属于用户级，硬塞进工作区会导致团队成员主题被强制改掉 - 慎放：插件启用状态（
extensions.ignoreRecommendations）或语言服务器路径（python.defaultInterpreterPath）——不同开发者本地环境差异大，建议用python.defaultInterpreterPath配合.vscode/settings.json+ 提示文档，而非写死绝对路径 - Windows 路径一律用正斜杠
/，比如"python.defaultInterpreterPath": "server/venv/Scripts/python.exe"，避免\被 JSON 解析为转义
最容易被忽略的一点：工作区设置只有在「以文件夹或 .code-workspace 方式打开」时才生效；如果只是把项目拖进已打开的 VSCode 窗口（尤其从外部资源管理器拖入），VSCode 默认仍走用户设置路径，.vscode 可能被静默忽略——务必检查左下角状态栏是否显示「Workspace」标签。
