VSCode多根工作区是将多个逻辑相关项目绑定为统一协作上下文，共享设置、扩展、调试配置及跨项目符号搜索。通过拖拽或菜单添加文件夹，另存为.code-workspace文件；支持工作区级settings.json、跨根跳转、复合调试等。
VSCode 的多根工作区（Multi-root Workspace）不是简单地打开多个文件夹，而是把几个逻辑相关的项目“绑定”在一起，共享一套设置、扩展行为和调试配置——适合微服务、前后端分离、插件+主程序等场景。
创建多根工作区
直接拖拽多个文件夹到 VSCode 窗口，会自动提示“将文件夹添加到工作区”；更规范的做法是：菜单栏选择 文件 → 将文件夹添加到工作区…，逐个加入。完成后点击 文件 → 另存为工作区…，保存为一个 .code-workspace 文件（本质是 JSON），以后双击它就能一键加载全部项目。
统一管理设置与扩展
工作区级设置（.vscode/settings.json）会覆盖用户级设置，对所有根文件夹生效。比如统一禁用某扩展的格式化、设置 ESLint 路径、或让 Prettier 忽略某个子目录。注意：扩展本身是否在多根下生效，取决于它是否声明支持 "extensionKind": ["workspace"] —— 大多数主流语言/调试扩展都已支持。
跨项目跳转与符号搜索
按 Ctrl/Cmd+P 输入 @ 可全局搜索符号（函数、类、变量），即使定义在另一个根目录里；右键“转到定义”或“查找所有引用”，VSCode 会自动跨文件夹解析。前提是各项目有正确配置的语言服务器（如 TypeScript 的 tsconfig.json、Python 的 pyproject.toml 或 venv 路径）。
集中调试多个服务
在工作区根目录的 .vscode/launch.json 中，可定义多个 configurations，每个指定不同项目的 program、cwd 和 env。启用 复合配置（compound） 还能一键启动前端 + 后端 + 数据库 mock 服务。注意路径要用 ${workspaceFolder:project-name} 变量精准指向对应根目录，避免混淆。
基本上就这些。多根工作区不复杂，但容易忽略它和普通“多窗口”的本质区别——它是协作上下文，不是视觉分组。
