.vscode/settings.json需位于项目根目录且通过“Open Folder”打开才生效，否则被忽略；右下角显示“工作区”、设置页切换至Workspace标签为关键验证点。
工作区配置不是“打开设置点几下”就能生效的事，它依赖明确的文件位置、正确的加载方式和清晰的优先级认知。直接改用户设置或拖拽文件夹进窗口，90% 的配置冲突都源于此。
为什么 .vscode/settings.json 没生效
最常见原因是 VSCode 根本没把它当工作区读——它只在你通过 File → Open Folder 打开项目根目录时才加载 .vscode/settings.json；用 Open File 或双击单个文件打开，这个文件就完全被忽略。
- 检查右下角状态栏是否显示「工作区」字样；显示「用户」说明当前未识别为工作区
- 按
Ctrl+,（Win/Linux）或Cmd+,（macOS），右上角切换到 Workspace 标签页：如果一片空白或提示“未在工作区中”，就是路径或打开方式错了 -
.vscode文件夹名必须全小写，Settings.json或SETTINGS.JSON都无效 - 某些设置项（如
telemetry.enableTelemetry、security.allowedUris）根本不能被工作区覆盖，搜索时右侧图标灰显即表示不支持
如何让 .code-workspace 真正接管多项目
.code-workspace 不是快捷方式，而是必须手动创建并保存的 JSON 文件。临时添加文件夹（File → Add Folder to Workspace…）不会持久化任何配置，也不写入扩展启用状态或调试设置。
- 启动空窗口 → 依次添加文件夹 → File → Save Workspace As…，保存为
my-system.code-workspace（建议带语义） -
"folders"字段必须是数组，写成"folder"或漏掉方括号会导致整个配置静默失效 -
"path"值推荐用相对路径（相对于.code-workspace文件所在目录），否则迁移后路径断裂 - 修改
"extensions"字段后，必须执行Developer: Reload Window（Ctrl+Shift+P调出命令面板），否则扩展启用状态不会刷新
终端路径、环境变量和扩展怎么做到“一项目一隔离”
工作区级设置能控制终端初始路径和注入环境变量，但扩展无法真正卸载——只能靠 extensions.json 推荐 + settings.json 显式开关来约束行为。
- 终端路径默认为第一个添加的文件夹，想改？在
.code-workspace的"settings"里加："terminal.integrated.cwd": "${workspaceFolder:backend}" - 项目专属环境变量写在
.vscode/settings.json中："terminal.integrated.env.linux"（Linux）、"terminal.integrated.env.windows"（Windows）等 - 禁用某扩展对当前工作区的影响，不是卸载它，而是设
"esbenp.prettier-vscode.enable": false这类开关项 - 要引导团队装对扩展，在
.vscode/extensions.json写"recommendations"列表；但注意："unwantedRecommendations"只起提示作用，不能强制屏蔽
真正难的不是写配置，而是理解 VSCode 加载配置的链条：它先看是不是以文件夹形式打开 → 再找 .vscode/settings.json → 再叠加 .code-workspace 里的 settings → 最后才考虑用户设置。任何一个环节断了，你就以为“配置失效”，其实是根本没走到那一步。
