多根工作区不是多个项目共存，而是将多个独立文件夹挂载到同一窗口的配置容器，各文件夹保持自身路径、设置和扩展行为，不共享构建上下文或自动合并配置。
多根工作区到底是不是“多个项目共存”
不是。VSCode 的多根工作区（Multi-root Workspace）本质是一个配置容器，它把几个独立文件夹“挂载”进同一个窗口，但每个文件夹仍保持自身路径、设置和扩展行为。你不能靠它让两个项目共享 node_modules 或自动合并 tsconfig.json —— 它不提供跨根的构建/编译上下文，只提供统一的 UI 管理界面。
常见误用场景：想用多根工作区实现“微前端主子应用联动调试”，结果发现 Debugger for Chrome 无法同时 attach 两个服务，或者 eslint 规则在根 A 生效、在根 B 失效。这是因为扩展默认按活动文件所在根加载配置，而非全局生效。
如何正确创建 .code-workspace 文件
手动新建 JSON 文件比用菜单更可控，尤其当路径含空格或中文时，GUI 方式容易漏转义。
- 在空白文件夹中新建
my-workspace.code-workspace - 写入标准结构，注意
folders是数组，settings是可选顶层字段：
{
"folders": [
{ "path": "frontend" },
{ "path": "../backend" },
{ "path": "shared-utils" }
],
"settings": {
"editor.tabSize": 2,
"files.exclude": { "**/dist": true }
}
}
⚠️ 路径必须是相对于 .code-workspace 文件自身的相对路径，不是相对于 VSCode 启动目录；用绝对路径虽可行，但会破坏团队协作一致性。
settings.json 在多根下的作用域优先级
设置生效顺序是：文件内设置 .vscode/settings.json .code-workspace 中的 settings 字段 .vscode/settings.json，它们不会被覆盖，而是与工作区 settings 合并（同名键后者覆盖前者）。
典型冲突场景：
-
frontend/.vscode/settings.json设了"typescript.preferences.importModuleSpecifier": "relative" -
.code-workspace里又设了"typescript.preferences.importModuleSpecifier": "non-relative" - 结果：在 frontend 根下打开的 TS 文件，实际使用的是工作区设置（后者优先）
若需保留各项目独立配置，就别在 .code-workspace 里写语言相关设置，只放 UI 类通用项（如 workbench.colorTheme、editor.fontFamily）。
终端和任务（tasks）默认作用于哪个根
VSCode 终端启动时，默认工作目录是“当前打开的活动文件所在的文件夹”。如果没打开任何文件，就取第一个 folders[0]。这会导致：npm run dev 在错误根下执行，报错 package.json not found。
解决办法：
- 右键某个文件夹 →
Open in Integrated Terminal，强制指定根 - 在
.code-workspace中定义tasks，并为每个 task 显式指定"group": "build"和"presentation": { "echo": true, "reveal": "always", "focus": false }，再配合"cwd"字段：
"tasks": [
{
"label": "start-frontend",
"type": "shell",
"command": "npm run dev",
"cwd": "${workspaceFolder:frontend}",
"group": "build"
}
]
${workspaceFolder:frontend} 中的 frontend 必须与 .code-workspace 里 folders 数组中某项的 name 字段一致；若未设 name，则默认取路径最后一段（如 "path": "frontend" → name 为 frontend）。
真正容易被忽略的是：任务面板里的 “Run Task” 列表，只显示当前活动编辑器所在根的任务 —— 换句话说，你得先点开 frontend 下的任意文件，才能看到 start-frontend。这个行为没有开关，也无法全局列出所有根的任务。
