真正的多根工作区必须通过“File > Save Workspace As…”生成.code-workspace文件，显式声明文件夹路径及分层配置，否则仅为多文件夹模式，导致调试、扩展、设置等功能异常。
VS Code 的多根工作区不是“多个文件夹随便拖进去就行”，它本质是用一个 code-workspace 文件显式声明项目边界和配置归属——不理解这点，就容易遇到调试断点失效、扩展行为错乱、设置被覆盖等问题。
什么是真正的“多根工作区”而不是“只是打开了多个文件夹”
直接把多个文件夹拖进 VS Code 窗口，VS Code 会以“多文件夹模式”打开，但此时没有统一的根配置，settings.json、launch.json、tasks.json 都默认落在第一个文件夹里，其他文件夹无法独立定义调试器或任务。真正的工作区必须通过 File > Save Workspace As… 生成一个 .code-workspace 文件，它是一个 JSON，明确列出每个文件夹路径，并支持为整个工作区或每个文件夹单独配置。
- 工作区文件里可写
"folders": [{"path": "backend"}, {"path": "frontend"}] - 支持在
"settings"下设全局配置，也可在某个"folders"项里加"settings"做子文件夹专属配置 - 不保存为
.code-workspace，就等于没启用多根工作区机制
调试时 launch.json 放哪儿才生效
VS Code 调试器只认当前“工作区作用域”下的 launch.json：如果没用 .code-workspace，它只查第一个打开的文件夹；如果用了工作区，它优先查工作区根目录下的 .vscode/launch.json，其次才是各文件夹自己的 .vscode/launch.json。但更稳妥的做法是——在工作区级 launch.json 中用 "configurations" 显式指定每个项目的 "cwd" 和 "program"，避免依赖自动发现。
- 错误做法：在
frontend/里放launch.json，期望它对整个工作区生效 → 不会 - 正确做法：工作区根目录建
.vscode/launch.json，每个configuration加"cwd": "${workspaceFolder:frontend}" -
${workspaceFolder:xxx}是关键变量，xxx必须与.code-workspace中folders的name字段一致（没设name就默认用文件夹名）
扩展和设置如何按项目隔离又共享
有些扩展（比如 ESLint、Prettier）会读取工作区根目录的配置，有些（比如 GitLens）则按活动文件所在文件夹自动切换上下文。设置层面，有三层作用域：用户级（全局）、工作区级（.code-workspace 里的 settings）、文件夹级（各文件夹下 .vscode/settings.json）。优先级是：文件夹级 > 工作区级 > 用户级。
- 想让所有项目共用同一套代码格式规则？在工作区
settings里写"editor.formatOnSave": true - 但
backend要用 Python，frontend要用 TypeScript？分别在各自文件夹的.vscode/settings.json里设"files.associations"和"eslint.validate" - 禁用某个扩展对某文件夹生效？在该文件夹的
settings.json里加"extensions.ignoreRecommendations": true
常见陷阱：Git 状态混乱、终端启动路径错乱
多根工作区里，源码管理视图（Source Control）默认聚合所有文件夹的 Git 状态，看似方便，实则容易误操作——比如在一个文件夹里 commit，却顺手 push 了另一个未检查的文件夹变更。终端也一样：Ctrl+` 默认打开的是“活动文件所在文件夹”的终端，但如果活动文件是工作区根目录的 JSON，终端就会在空目录启动。
- 解决 Git 混乱：右键点击源码管理面板顶部的仓库名，选择
Hide Repository，隐藏掉暂时不想操作的仓库 - 终端路径问题：打开终端前先聚焦到某个文件（如
backend/src/index.ts），再按Ctrl+`；或使用命令面板运行Terminal: Create New Terminal (In Active Workspace Folder) - 别依赖“自动识别”，多根工作区里一切路径相关的功能都强烈建议显式指定作用域
工作区文件本身是纯 JSON，没有魔法，但它决定了 VS Code 的上下文边界。很多人卡在“为什么这个插件不生效”“为什么断点不进”，其实只是漏掉了 .code-workspace 这一层声明，或者没搞清 ${workspaceFolder:xxx} 的匹配逻辑。
