必须通过.code-workspace文件显式定义才算真多根工作区；窗口右下角显示workspace且资源管理器列出多个带图标根目录才生效，显示folder即为假多根。
多根工作区不是“让 VSCode 打开多个文件夹”的快捷方式，而是必须通过 .code-workspace 文件显式定义的一组项目边界——不生成这个文件，所有后续调试、扩展、终端行为都会退化为单根逻辑，问题只会越积越多。
怎么判断你用的真是多根工作区，而不是“假多根”
最直接的信号是窗口右下角显示的是 Workspace 还是 Folder。显示 Folder 说明你只是拖了多个文件夹进来，VSCode 根本没启用多根机制；只有显示 Workspace，且资源管理器顶部列出多个带图标的根目录（如 frontend、backend），才算真正生效。
- 常见错误现象：按
Ctrl+P搜不到其他文件夹下的文件，Go to Symbol in Workspace只返回当前文件夹符号 → 本质是没走多根路径索引 - 误操作典型路径：先
Open Folder→ 再点Add Folder to Workspace→ 关闭重开 → 依然只认第一个文件夹 - 正确起点必须是空窗口或已保存的
.code-workspace文件，从头用Add Folder to Workspace添加，不能补救
保存为 .code-workspace 后路径怎么写才不坑队友
.code-workspace 是纯 JSON，folders 字段里填绝对路径最省事但最不可协作；填相对路径又受限于启动位置。实际可用的折中方案只有两个：
- 用环境变量：例如
"path": "${env:HOME}/dev/myapp/frontend"或"path": "${env:USERPROFILE}\projects\backend"，跨平台基础兼容，路径可读性强 - 团队交付时留占位符：比如
"path": "./projects/backend"，并在README.md明确要求成员把整个工作区目录结构解压到统一父目录下再双击打开 - 绝对不要在
folders里写死类似/Users/alex/project这种路径——别人拉下来直接报错Unable to open workspace: path does not exist
调试 launch.json 和终端 cwd 怎么精准指向对应项目
多根下 launch.json 必须放在工作区根目录（即 .code-workspace 文件所在目录）的 .vscode/ 下，不能塞进某个子项目里。否则 VSCode 会忽略或只对第一个文件夹生效。
- 每个
configuration必须显式指定"cwd": "${workspaceFolder:frontend}"，其中frontend要和.code-workspace中对应folders的name字段一致；没设name就默认用文件夹名 - 终端新建后默认
cwd是「最近激活的文件所属根」，不是第一个添加的文件夹；右上角终端下拉菜单可手动切换，别指望自动匹配 - 如果
launch.json里漏了cwd或变量拼错，调试时大概率报错Cannot find module或找不到package.json
扩展和 settings 怎么分层又不打架
设置有三层优先级：文件夹级（各项目根下的 .vscode/settings.json） > 工作区级（.code-workspace 里的 settings 字段） > 用户级。但扩展启用范围不自动分层，得手动指定。
- 语言类扩展（如
ms-python.python）建议在对应项目文件夹右键 →Configure Extension Settings in…→ 选This Folder，避免 backend 的 Python 解释器干扰 frontend 的 TypeScript - 通用工具类扩展（如
esbenp.prettier-vscode）可设为This Workspace，统一格式规则 - 工作区级
settings适合写全局开关（如"editor.formatOnSave": true），但路径类配置（如"python.defaultInterpreterPath"）必须下沉到各文件夹自己的.vscode/settings.json，否则会覆盖出错
最容易被忽略的点是：切换工作区后，之前打开的编辑器标签页不会自动关闭或重绑定上下文——那些残留的 src/App.tsx 标签可能还在，但 ESLint 规则、Git 状态栏、甚至断点都已失效。这不是 bug，是设计如此；每次切工作区前，记得按 Ctrl+K W 关掉全部标签页。
