多根工作区需从空窗口用“add folder to workspace”创建，而非“open folder”；.code-workspace存绝对路径，共享时易失效；扩展、调试、终端行为按活动根生效；不适用于有构建耦合的场景。
多根工作区怎么创建才不会变成单文件夹打开
VSCode 默认打开文件夹就是单根，想真正启用多根工作区，必须用「添加文件夹到工作区」而不是「打开文件夹」。直接双击或拖入一个文件夹，它永远只是单根；哪怕你后续再加别的，也得从空工作区起步。
实操建议：
- 启动 VSCode 后先按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Add Folder to Workspace...，选第一个匹配项 - 第一次添加后，窗口右下角会显示
Workspace而不是Folder—— 这是唯一可靠的识别标志 - 不要用「File → Open Folder」，否则即使后续保存为
.code-workspace文件，历史配置（比如调试 launch 设置）也可能不生效
保存工作区文件后为什么别人打不开或路径错乱
.code-workspace 是纯 JSON，里面存的是绝对路径。一旦共享给同事或换电脑，路径失效是常态，不是 bug，是设计如此。
常见错误现象：
- 别人打开后只显示「No folders in workspace」
- 某个文件夹图标变灰，hover 提示
Path does not exist - 终端默认工作目录仍是第一个文件夹，不是你期望的那个
实操建议：
- 团队协作时，把
.code-workspace当作模板，而非交付物；在 README 里写清楚要手动添加哪些路径 - 如果必须提交，把路径字段留空或填占位符（如
"./projects/backend"），靠相对路径 + 手动重定向解决 - 避免在
.code-workspace里写死settings中的路径类配置（如files.exclude），这类设置应下沉到各项目根目录的.vscode/settings.json
多根下扩展、调试、终端行为和单根有啥不同
不是所有功能都自动适配多根。VSCode 的扩展机制决定了：有些插件压根没实现多根支持，有些则只对「活动文件所在根」生效。
使用场景与影响：
-
Debug：每个根可独立定义.vscode/launch.json，但「运行和调试」侧边栏只显示当前活动编辑器所在根的配置；切换根目录不会自动切换调试配置 -
Terminal：新建终端默认 cwd 是「最近激活的文件所属根」，不是第一个添加的根；可通过终端右上角下拉菜单手动切换 -
Extensions：像ESLint或Prettier会分别读取各根下的配置文件（.eslintrc.js、.prettierrc），但GitLens的仓库视图只显示第一个根的 Git 状态 -
Settings Sync：工作区级设置（settings.json里的"workbench.colorTheme"这类）会被同步，但路径相关设置不会自动迁移
什么时候不该用多根工作区
多根不是万能胶。它适合逻辑并列、无强依赖的多个项目（比如微服务的 frontend + backend + shared-lib），但不适合有构建耦合或统一 CLI 管理的场景。
容易踩的坑：
- 用
npm run dev启动全栈时，发现两个根的进程互相抢端口或热更冲突 —— 多根不提供进程隔离，只是 UI 分组 - 想用
Find in Files搜整个工作区，结果某些根因为files.exclude配置太激进，根本搜不到 - 误以为多根能替代 monorepo 工具（如
pnpm workspaces或nx），结果依赖管理、版本发布还得另起一套
真正需要跨项目联动构建、测试、发布的，老老实实用 monorepo 结构，别靠 VSCode 工作区硬撑。
多根工作区的本质是「视觉分组 + 配置聚合」，不是项目关系建模工具。路径、执行上下文、生命周期，全都得自己对齐。
