VSCode的tasks.json必须放在工作区根目录（与.code-workspace同级）是因为任务系统仅在此层级查找配置文件，且该位置支持多根工作区下所有文件夹共享任务；若置于子项目.vscode/内则仅局部生效，无法跨文件夹调用。
工作区级 tasks.json 是唯一能跨项目共享任务定义的方式，单个项目 .vscode/tasks.json 互不生效。
为什么 tasks.json 必须放在工作区根目录（.code-workspace 同级）？
VSCode 的任务系统只在工作区根层级查找 tasks.json。如果你把 tasks.json 放在某个子项目（如 ./frontend/.vscode/tasks.json）里，它只会对那个文件夹生效，且无法被其他根目录下的文件识别或调用。
常见错误现象：Task 'build' not found 或命令面板里看不到自定义任务，往往是因为 tasks.json 放错了位置。
- 正确路径：与
my-project.code-workspace文件同级，即./my-project.code-workspace和./tasks.json（注意不是.vscode/tasks.json） - VSCode 不会自动创建这个文件，必须手动新建并保存在工作区根目录
- 该
tasks.json会被所有 folders 共享，且支持通过"group"或"presentation"控制终端行为
tasks.json 中如何指定不同项目的执行路径？
关键在于用 "cwd" 字段动态指向各项目根目录，配合 "label" 命名区分任务来源。VSCode 会根据当前活动编辑器所在的 folder 自动解析相对路径。
例如，你有 ./backend 和 ./frontend 两个 folder，想分别运行各自 package.json 脚本：
{
"version": "2.0.0",
"tasks": [
{
"label": "backend:build",
"type": "shell",
"command": "npm run build",
"cwd": "${fileDirname}/../backend",
"group": "build",
"presentation": { "echo": true, "reveal": "always", "panel": "shared" }
},
{
"label": "frontend:dev",
"type": "shell",
"command": "npm run dev",
"cwd": "${fileDirname}/../frontend",
"group": "develop",
"presentation": { "echo": true, "reveal": "silent", "panel": "shared" }
}
]
}
说明：
-
"cwd"用${fileDirname}动态定位——当前打开文件所在路径，再向上跳转；避免硬编码绝对路径 -
"panel": "shared"让多个任务复用同一个终端，减少窗口碎片 - 如果某任务需要固定路径（如构建整个 monorepo），直接写
"cwd": "${workspaceFolder}/scripts"
如何让任务自动识别当前编辑器所属的项目根目录？
VSCode 提供了 ${relativeFile}、${fileBasenameNoExtension} 等变量，但真正决定“当前项目上下文”的是编辑器焦点所在的 folder。任务本身不感知焦点，但你可以靠 "dependsOn" 或 shell 判断逻辑来间接适配。
更可靠的做法是：为每个项目定义独立 label，并在命令中加入路径判断逻辑（尤其适用于 Makefile 或 pnpm workspace 场景）：
{
"label": "run:current",
"type": "shell",
"command": "if [ -f package.json ]; then npm run dev; elif [ -f go.mod ]; then go run .; else echo 'no runnable project detected'; fi",
"cwd": "${fileDirname}",
"group": "develop"
}
使用场景：
- 你在
./backend里打开一个.go文件，执行此任务就跑go run . - 你在
./frontend里打开一个.js文件，执行就跑npm run dev - 避免为每个项目重复写一堆相似 task，节省配置维护成本
共享任务时容易忽略的兼容性问题
跨平台脚本在 Windows 和 macOS/Linux 上行为不一致，tasks.json 默认走 shell 模式，Windows 下可能找不到 sh 或 npm。
解决方式：
- 始终用
"type": "shell"，而非"process"—— 它会调用系统默认 shell，更稳定 - 避免直接写
cd ./backend && npm run build，改用"cwd"+ 单条命令 - Windows 用户若遇到
'npm' is not recognized，需确认 VSCode 终端继承了正确的 PATH（检查设置里terminal.integrated.env.windows） - 团队共享时，建议在
.code-workspace中加"extensions.recommendations"推荐npm或pnpm插件，避免本地缺失 CLI
最易被忽略的一点：任务面板不会自动刷新。修改 tasks.json 后，必须重启 VSCode 或执行 Developer: Reload Window，否则旧任务仍留在命令面板里。
