tasks.json在多根工作区中不自动跨项目生效，是因为VSCode默认仅在当前活动文件所属根目录下查找.vscode/tasks.json，不会自动合并或遍历所有根目录；若需全局任务，必须将tasks.json置于.code-workspace同级目录的.vscode/中，并使用${workspaceFolder:名称}等变量动态指定路径。
为什么 tasks.json 在多根工作区里不自动跨项目生效
VSCode 默认只在当前活动文件所属的根目录下查找 .vscode/tasks.json，哪怕你打开了三个项目，编辑器也不会主动合并或遍历所有根目录下的 tasks.json。结果就是：你在 frontend 文件夹里按 Ctrl+Shift+P → “Tasks: Run Task”，只能看到 frontend 自己定义的任务；backend 的构建脚本压根不会出现。
这不是 bug，而是设计——VSCode 把任务作用域默认绑定到“当前活动文件所在的文件夹”。跨项目调用的前提，是显式声明任务归属或统一入口。
- 每个子项目仍可保留自己的
.vscode/tasks.json，用于本地开发调试 - 真正需要“统一管理”的任务（比如一键启动前后端、打包全栈镜像），必须收口到工作区顶层
-
.code-workspace文件本身不支持直接写 tasks，但可通过tasks.json放在工作区同级目录（即和.code-workspace并列）来触发全局识别
把 tasks.json 放哪才能被整个工作区识别
VSCode 会扫描以下两个位置的 tasks.json：
- 当前打开的单个文件夹根目录下的
.vscode/tasks.json（局部） - 与
.code-workspace文件同级目录下的.vscode/tasks.json（全局）——注意：这个.vscode必须和.code-workspace在同一层，不是某个子项目里
例如你的工作区文件是 my-monorepo.code-workspace，那么正确路径是：
my-monorepo.code-workspace .vscode/ └── tasks.json ← 这里写的任务，整个工作区都能看到
如果放错位置（比如塞进 ./backend/.vscode/tasks.json），它就只是 backend 的私有任务。
常见错误：以为只要在 .code-workspace 里加个 "tasks" 字段就能配置——不行，JSON schema 不支持该字段，会被忽略。
怎么写一个能跨项目执行的 shell 任务
关键在于路径处理：任务命令中不能写死相对路径（如 cd frontend && npm run dev），因为工作区没有“当前工作目录”概念。要用 VSCode 提供的变量动态解析目标文件夹位置。
- 用
${workspaceFolder:frontend}指向名为frontend的文件夹路径（需在.code-workspace的folders中定义了"name": "frontend"） - 避免使用
../或硬编码路径，否则切换机器或克隆仓库后极易失败 - 推荐用
shell类型而非process，前者支持多行命令和管道，后者仅执行单个二进制
示例（放在工作区级 .vscode/tasks.json 中）：
{
"version": "2.0.0",
"tasks": [
{
"label": "dev: fullstack",
"type": "shell",
"command": "cd ${workspaceFolder:frontend} && npm run dev & cd ${workspaceFolder:backend} && npm run dev",
"group": "build",
"isBackground": true,
"problemMatcher": []
}
]
}
注意：${workspaceFolder:xxx} 中的 xxx 必须和 .code-workspace 里 folders 数组中某个 name 完全一致，大小写敏感。
如何避免终端窗口混乱和进程残留
多项目并行启动服务时，VSCode 默认为每个任务新开一个集成终端标签页，很快就会堆满。更麻烦的是，关闭任务不会自动 kill 子进程（比如 node server），导致端口被占、重复启动失败。
- 加
"isBackground": true后，必须配"problemMatcher"，否则任务永远显示“正在运行”，无法手动终止 - 推荐用
concurrently或npm-run-all统一管理多进程生命周期，而不是拼接&& - 在任务里加
"presentation": { "echo": false, "reveal": "never", "focus": false, "panel": "shared" }，让所有相关任务复用同一个终端面板 - 退出前手动运行
kill-port 3000 8000类命令不现实，建议在package.json的 script 里封装predev清理逻辑
真正容易被忽略的点是：VSCode 的任务系统不管理进程树。它只负责启动命令，不负责回收。跨项目任务越复杂，越要靠脚本自身做守卫，而不是依赖编辑器。
