工作区配置依赖项目根目录下的.settings.json文件，仅覆盖全局设置；90%失效源于错配路径、误改用户设置、注释干扰或相对路径；须通过open folder打开、确认workspace标签、确保.vscode/settings.json存在且为纯json。
工作区配置不是“开个开关就隔离”，而是靠 settings.json 文件在项目根目录下生效，且只覆盖（不删除、不干扰）全局设置；错配路径、误改用户设置、写进注释或相对路径——这四类操作占了 90% 的失效原因。
如何确认你正在编辑工作区配置而非全局设置
VSCode 设置编辑器默认打开的是用户（User）设置，直接点「Edit in settings.json」会写进全局文件。真正的工作区配置必须满足三个条件：
- 你通过 File → Open Folder… 打开了一个文件夹（不是单个文件）
- 右上角设置面板显示的是 Workspace 标签（不是 User 或 Remote）
-
.vscode/settings.json文件真实存在于该文件夹根目录下，且是纯 JSON（无注释）
常见错误现象：editor.tabSize 改了之后，打开其他项目也变成 2 —— 这说明你改的是用户级 settings.json，或者根本没生成 .vscode 文件夹。
为什么 python.defaultInterpreterPath 填相对路径不生效
VSCode 对解释器路径不做路径解析，只做字符串拼接后调用。填 "./venv/bin/python" 或 "venvScriptspython.exe" 都会失败，因为启动时工作目录不一定是项目根目录。
- 必须用绝对路径，例如：
"/Users/me/project/venv/bin/python"（macOS/Linux）或"C:/project/venv/Scripts/python.exe"（Windows） - Windows 下优先用正斜杠
/，避免双反斜杠\被 JSON 解析为转义字符 - 验证是否生效：打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P），运行Python: Select Interpreter，看路径是否已预填且可选中
files.exclude 和 search.exclude 设错会导致文件树空白
这两个配置项影响资源管理器和全局搜索的可见性，但语法敏感、层级嵌套容易出错。
- 值必须是对象（不是数组），键是 glob 模式，值是
true，例如："**/node_modules": true - 不要写成：
"**/node_modules/**": true（多加/**可能导致匹配过宽，连 src 下的模块都消失） - 修改后立即刷新文件树：按
Cmd+R/Ctrl+R或右键资源管理器 →Refresh - 临时排查建议：先把整个
files.exclude块注释掉（手动删掉，JSON 不支持注释），确认文件树恢复再逐项加回
多根工作区里 .code-workspace 文件的路径必须用相对路径
如果你把 .code-workspace 提交到 Git 并共享给团队，路径写成绝对路径（如 "path": "/home/alice/project/client"）会导致别人打开失败。
- 所有
folders.path必须以./开头，例如："path": "./client"或"path": "../shared-lib" -
settings块里可以放通用配置（如editor.tabSize），但语言专属设置（如python.defaultInterpreterPath）不能放这里——它不支持按文件夹区分，只能写在各子项目的.vscode/settings.json中 - 保存后，务必用
File → Open Workspace from File…打开，而不是Open Folder…，否则folders列表不会加载
最常被忽略的一点：VSCode 不会自动创建 .vscode 文件夹。你得自己建、自己放、自己确保它在正确位置——没有“智能识别项目类型后自动注入配置”这回事。任何依赖“自动生效”的预期，都会在第一次 git clone 后落空。
