工作区设置优先级高于用户设置，确保修改的是工作区设置需以文件夹方式打开项目、在设置界面搜索配置项后点击文件夹图标选择“add to workspace settings”，vscode将自动生成合法.vscode/settings.json；手动编辑时禁用注释，且须确认右上角显示workspace标签。
工作区设置不是“隔离开关”，而是优先级更高的覆盖层：只要 .vscode/settings.json 存在且位于你用 VSCode 打开的文件夹根目录，它就会自动生效，只影响该文件夹及其子目录——其他项目完全不受干扰。
怎么确保改的是工作区设置，而不是用户设置
VSCode 设置编辑器默认打开的是用户（User）设置，直接点「Edit in settings.json」写进去的内容会全局生效，这是最常踩的坑。
正确做法是：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）打开设置界面 - 在搜索框输入目标配置项，例如
python.defaultInterpreterPath - 找到后点击右侧的「文件夹图标」（Folder icon），再选「Add to Workspace Settings」
- VSCode 会自动创建
.vscode/settings.json并写入合法 JSON，带注释、无语法错误
如果手动编辑，注意：.vscode/settings.json 不支持 JSONC 注释（即双斜杠 // 或块注释 /* */），否则整个文件会被忽略。
为什么 .vscode/settings.json 没生效
常见失效原因不是配置写错了，而是打开方式不对：
- 用资源管理器右键某个
.py文件 → 「在 VSCode 中打开」→ 实际是单文件模式，.vscode根本不被识别 - 没以文件夹方式打开：必须通过
File → Open Folder…，且窗口左下角状态栏显示 Workspace 标签 -
.vscode文件夹不在你打开的那个根目录下（比如放到了子目录里） - 配置项本身不支持工作区级覆盖（极少数设置如
workbench.colorTheme只能在用户级设）
验证是否生效：打开设置界面，看右上角是否显示 Workspace；或者检查资源管理器中是否可见 .vscode/settings.json 文件。
多根工作区（.code-workspace）怎么配 settings
单个 .vscode/settings.json 只能管一个文件夹；要同时管理 client 和 server 等多个根目录，必须用 .code-workspace 文件。
它不是 VSCode 自动生成的，必须手动创建并保存：
- 先用
File → Add Folder to Workspace添加所有目标文件夹 - 再执行
File → Save Workspace As…，保存为my-project.code-workspace - 打开该文件，编辑顶层
"settings"字段，例如：{ "folders": [ {"path": "client"}, {"path": "server"} ], "settings": { "editor.formatOnSave": true, "[python]": {"editor.tabSize": 4}, "[javascript]": {"editor.tabSize": 2} } }
注意："path" 是相对于 .code-workspace 文件所在位置的路径；不要写 "./server/venv/bin/python" 这类相对路径作为解释器，VSCode 解析时工作目录不确定，大概率失败。
提交到 Git 时要注意什么
.vscode/settings.json 可以也建议提交到版本控制，让团队成员获得一致体验，但有三个关键限制：
- 不要提交本地绝对路径，如
"python.defaultInterpreterPath": "/Users/me/project/venv/bin/python" - 避免提交敏感值，如 API key、token、密码相关字段（哪怕只是示例注释）
- 若项目含多种语言，优先用语言特定配置（如
"[python]"块），而非粗暴覆盖全局"editor.tabSize"，否则可能干扰 Markdown 或 JSON 编辑
真正容易被忽略的是：语言特定配置（如 "[python]"）必须写在 settings 对象内部，不能独立成顶层字段；而且它只对对应语言文件生效——这点在混合项目里一旦写错位置，就全盘失效。
