VSCode多根工作区是单窗口管理多个项目根目录，需通过“Add Folder to Workspace”并保存为.code-workspace文件实现；路径推荐用环境变量如${env:HOME}；设置分三层优先级，调试配置按根目录隔离且合并加载。
多根工作区不是打开多个窗口
VSCode 的多根工作区（Multi-root Workspace）和「同时打开多个文件夹 → 每个在独立窗口」是两回事。后者只是多个独立实例，彼此不共享设置、扩展状态或调试配置；前者才是真正的「一个窗口管理多个项目根目录」，所有根目录共用同一套 settings.json（工作区级）、同一组断点、同一个终端会话（可切换根目录）、同一份任务/启动配置。
常见错误现象：Ctrl+P 搜索不到另一个根目录下的文件，或者 Go to Symbol in Workspace 只搜当前文件夹 —— 这说明你没真正创建多根工作区，只是拖了多个文件夹进窗口。
- 正确做法：用
File > Add Folder to Workspace...（不是Open Folder）往已有空工作区里加目录 - 保存时必须显式执行
File > Save Workspace As...，生成一个.code-workspace文件，否则关闭后配置就丢了 - 不要把项目文件夹直接拖进已打开的单根窗口——它只会变成临时标签页，不会被纳入工作区结构
workspace 文件里路径写相对还是绝对？
.code-workspace 是个 JSON 文件，里面 folders 字段列的是每个根目录的路径。这里填相对路径还是绝对路径，直接影响可移植性与协作体验。
使用场景：团队共用一份 .code-workspace，有人用 Windows，有人用 macOS；或者你经常在不同机器间同步工作区配置。
- 填绝对路径（如
"path": "/Users/me/project/backend"）→ 本地能用，但别人拉下来大概率打不开，路径不存在直接报错Unable to open workspace: path does not exist. - 填相对路径（如
"path": "backend"）→ 要求所有根目录都在同一父目录下，且你用code myproject.code-workspace命令从该父目录启动 VSCode，否则路径解析失败 - 推荐折中方案：用
${env:HOME}或${env:USERPROFILE}变量（VSCode 支持），例如"path": "${env:HOME}/dev/myapp/frontend"，兼顾可读性和跨平台基础兼容
extensions 和 settings 怎么分层生效？
多根工作区里，扩展（extensions）是全局启用的，但配置（settings）有三层优先级：用户级 settings.json → 工作区级（即 .code-workspace 里的 settings 字段）→ 单文件夹级（各根目录下 .vscode/settings.json）。容易混淆的是「工作区级设置」到底管不管得住每个根目录。
性能影响：如果在工作区级写了大量语言特有配置（比如 "python.defaultInterpreterPath"），而某个根目录根本不用 Python，这些配置仍会被加载并参与匹配，可能轻微拖慢启动或语言服务初始化。
- 工作区级
settings字段对所有根目录生效，适合通用规则（如"editor.tabSize": 2） - 想给某一个根目录单独配，必须在它自己的
.vscode/settings.json里写，且该文件内容会覆盖工作区级同名配置 - 扩展本身不能按根目录开关，但可通过
"extensions.ignoreRecommendations": true配合.vscode/extensions.json控制推荐行为
调试时 launch.json 怎么对应多个根目录？
VSCode 调试器默认只认当前活动编辑器所在根目录的 .vscode/launch.json。如果你在前端目录打开一个 JS 文件，调试器却试图运行后端的 Python 启动配置，大概率是因为你把所有 launch 配置都堆在一个根目录的 launch.json 里，没做区分。
错误现象：No configuration found to debug，或选了 launch 配置却提示 Cannot find runtime 'node' —— 实际是调试器在错误根目录下找 package.json 或解释器路径。
- 每个根目录可自带独立的
.vscode/launch.json，VSCode 会自动合并它们，调试选择器里显示所有配置 - 关键要检查每个配置里的
cwd和program（或args）路径是否基于自身根目录，别写死成其他项目的相对路径 - 如果共用一套调试逻辑（比如统一用 Docker Compose），建议用
compounds把多个配置组合起来，并在各自配置里用"__configurationTarget": "workspaceFolder"显式绑定作用域
复杂点在于：当多个根目录存在同名配置（比如都叫 Debug Server），VSCode 不会报错，但实际运行的是最后一个加载的——顺序由 .code-workspace 中 folders 数组顺序决定，这点很容易被忽略。
