多根工作区是 VSCode 通过。code-workspace 文件逻辑聚合多个独立项目的能力，共享设置与调试配置，同时保持各项目 Git 状态和配置独立；支持跨根搜索、调试和任务，但不支持嵌套根目录。
VSCode 的多根工作区（Multi-root Workspaces）不是简单地打开多个文件夹，而是把多个独立项目（甚至不同技术 栈）组织在一个统一的编辑器窗口里，共享设置、调试配置和扩展行为，同时保持各自独立的代码结构和 Git 状态。
什么是多根工作区
它是一个以 .code-workspace 为后缀的 JSON 文件，里面定义了一组文件夹路径（roots），每个路径对应一个本地目录。VSCode 会把它们“逻辑聚合”为一个工作区，而不是物理合并。这意味着：
- 每个文件夹保留自己的
.git、package.json、tsconfig.json等配置 - 终端、搜索、调试、任务等能力作用于所有根目录（可按需限定范围）
- 工作区级设置（
settings.json）优先于用户 / 文件夹级设置 - 不支持嵌套根目录（比如不能把子文件夹再加为一个 root）
如何创建和管理多根工作区
最常用方式是通过命令面板或菜单操作，而非手动写 JSON：
- 打开任意一个文件夹 → 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Add Folder to Workspace……
- 选中另一个项目目录，它就会被加入当前工作区
- 点击侧边栏标题栏的文件夹名 → 选择 Save Workspace As……，保存为
my-project.code-workspace - 以后双击这个文件，或用
code my-project.code-workspace命令即可直接打开整个工作区
已有的工作区可通过右键侧边栏的文件夹名，选择 Remove Folder from Workspace 移除某个根；拖动文件夹名可调整顺序（影响默认终端启动位置等）。
关键配置与实用技巧
打开 .code-workspace 文件，你会看到类似这样的结构：
{"folders": [ { "path": "backend"}, {"path": "frontend"}, {"path": "../shared-lib"} ], "settings": {"editor.tabSize": 2, "files.exclude": { "**/node_modules": true} }, "launch": {/* 调试配置 */}, "tasks": {/* 构建任务 */} }- 相对路径更安全 ：推荐使用相对于 .code-workspace 文件的相对路径（如
"backend"），避免硬 编码 绝对路径导致协作时失效 - 工作区设置只写共性项：比如统一缩进、隐藏 node_modules；项目特有配置（如 ESLint 规则）仍应放在各自文件夹内
- 调试可跨根复用：在
launch中用"cwd"或"program"显式指定路径，就能为 backend 启动服务、为 frontend 启动 dev server - 搜索默认覆盖全部根：但可在搜索框右上角点击文件夹图标，勾选 / 取消特定根目录，快速聚焦某一部分
常见问题与注意事项
多根工作区很灵活，但也容易踩坑：
- 扩展行为可能不一致：某些语言服务（如 Python、Go）依赖单一激活根目录，此时建议只让一个根启用对应扩展，或使用
"extensionKind"在extensions.json中约束 - Git 面板显示多个仓库：左侧源代码管理视图会列出每个根下的 Git 状态，切换分支、提交都独立操作，不会互相干扰
- 不要混用“打开文件夹”和“打开工作区”：如果已打开一个文件夹，再通过菜单添加其他文件夹，会自动转为临时工作区；务必记得保存为 .code-workspace 文件，否则关闭后丢失配置
- 符号链接需谨慎：VSCode 对软链接的支持有限，若某根是 symlink，部分功能（如跳转定义、智能提示）可能失效
基本上就这些。用好多根工作区，能让你在微 前端 、前 后端 联调、单体仓库拆分过渡等场景里，少开几个窗口，少切几次上下文，效率明显提升。
