VSCode工作区配置需手动编辑.settings.json或.code-workspace文件，生效依赖路径正确、优先级规则及重载操作；多根工作区下仅.code-workspace的settings生效，且字段错误会静默失效。
VSCode 没有内置的“开发者工具”面板来可视化编辑或调试工作区配置，所有配置管理都依赖文件系统和 JSON 结构本身；所谓“管理”，本质是手动编辑 .vscode/settings.json 或 .code-workspace 文件，并理解其加载逻辑与覆盖规则。
为什么改了 settings.json 却没生效
常见现象：在项目根目录下新建 .vscode/settings.json，写入 "editor.tabSize": 4，但打开文件后仍是 2 空格。
- 检查是否打开了多根工作区（状态栏显示 Workspace）：此时
.vscode/settings.json被忽略，只读取.code-workspace中的settings字段 - 确认文件路径正确：必须放在项目**根目录**下的
.vscode/子目录中，不能是src/.vscode/或拼错为.VSCode/ - 检查优先级冲突：用户级设置中可能启用了
"editor.detectIndentation": true，会覆盖tabSize—— 可显式设为false强制使用配置值 - VS Code 不会热重载
settings.json修改：保存后需重新打开文件夹，或执行Developer: Reload Window（Ctrl+Shift+P）
.code-workspace 文件里哪些字段一写错就静默失效
这个文件是纯 JSON，但 VS Code 对字段语义强校验，写错不会报错，而是直接跳过整个配置块。
-
folders数组中每个对象必须含path字段，值只能是相对路径（如"./backend"）或绝对路径（如"/home/user/project/api"），不支持~、$HOME或环境变量 - 路径禁止嵌套：同时存在
"./backend"和"./backend/src"会导致加载失败，提示folder is already in workspace -
settings是覆盖层，不继承注释、不保留缩进 —— 保存后所有注释被删，缩进强制为 2 空格，手动加的换行或空格会被抹平 -
launch.json必须放在.code-workspace所在目录的.vscode/下，且每个configuration必须用cwd显式指定子项目，例如"cwd": "${workspaceFolder:backend}"，不能写"./backend"
如何验证当前生效的是哪一层配置
打开命令面板（Ctrl+Shift+P），输入并执行 Preferences: Open Settings (JSON)，顶部会显示当前作用域标签：
- 若显示
User→ 正在编辑全局用户设置 - 若显示
Workspace→ 正在编辑.code-workspace中的settings - 若显示
Workspace Folder: my-project→ 正在编辑该项目根目录下的.vscode/settings.json
更直接的方式：在任意编辑器中右键 → Inspect Context Keys，查看 config.editor.tabSize 等实际解析值，它反映最终叠加结果，而非某一个源。
切换工作区后旧标签页还在，但行为异常怎么办
这是最易被忽略的上下文污染点：VS Code 不会自动清理跨工作区的打开文件。
- 已打开的
src/App.tsx标签页仍显示，但 ESLint 规则、Git 状态栏、调试器 cwd 都沿用前一个工作区的配置 - 解决方法只有两个：
Ctrl+K W关闭全部标签页，或启用"workbench.editor.closeOnFileDelete": true避免误删后残留无效页 - 没有自动过滤机制 —— 即便你已切换到新工作区，只要旧文件标签没关，它的语言服务、格式化、Linter 就可能继续运行，导致误报或格式错乱
复杂点在于：这种污染不可见，也不报错，只表现为“某些文件行为不一致”。真要排查，得先关掉所有标签页，再逐个打开新工作区里的文件验证。
