VSCode 的 tasks.json 天然项目级，仅对当前工作区根目录及其子目录生效，不跨工作区、不继承父目录或用户级配置，必须置于 .vscode/ 下且路径严格匹配。
VSCode 的任务（Tasks）默认是工作区（workspace）级别生效的，但“项目级”配置实际指的就是在 .vscode/tasks.json 中定义、且仅对当前文件夹及其子目录起效的任务——它天然就是项目级的，不需要额外作用域切换。
为什么 tasks.json 就是项目级的
VSCode 任务系统通过 .vscode/tasks.json 文件绑定到当前打开的文件夹（即“工作区根目录”）。只要这个文件存在，且你打开的是该文件夹（而非单个文件或上层父目录），所有任务就只对该目录下的代码生效。它不跨工作区，也不随用户设置全局生效。
- 打开一个子项目文件夹（如
./backend），.vscode/tasks.json就只影响backend及其子目录 - 若同时打开多个文件夹（多根工作区），每个文件夹可自带独立的
.vscode/tasks.json，互不干扰 - 没有
.vscode/tasks.json时，VSCode 不会自动继承父目录或用户级任务
tasks.json 必须放在项目根目录的 .vscode/ 下
路径错位是任务不触发的最常见原因。VSCode 只认当前工作区根目录下的 .vscode/tasks.json，不会向上查找或向下扫描。
- ✅ 正确：
/my-project/.vscode/tasks.json（打开/my-project时生效） - ❌ 错误：
/my-project/src/.vscode/tasks.json（打开/my-project时被忽略） - ❌ 错误：
~/.vscode/tasks.json（用户级配置，VSCode 不支持用户级任务定义）
如果你在子目录开发，要么把整个子目录作为独立工作区打开，要么把 tasks.json 提到它的父级根目录。
用 "group" 和 "presentation" 控制任务可见性与执行上下文
项目级任务常需区分构建、测试、格式化等场景，靠 "group" 字段归类，并配合快捷键或命令面板筛选；而 "presentation" 决定终端是否复用、是否显示、是否聚焦，直接影响开发流体验。
-
"group": "build"的任务会在「运行任务」面板中归入“构建”分组，按 Ctrl+Shift+P →Tasks: Run Build Task可快速触发 -
"presentation": { "echo": true, "reveal": "always", "focus": false, "panel": "shared", "showReuseMessage": true }表示复用同一终端面板，避免每次弹新窗口 - 若任务依赖当前文件（如 ESLint 当前文件），务必加
"args": ["${file}"]，否则默认在工作区根目录执行，路径可能出错
{
"version": "2.0.0",
"tasks": [
{
"label": "lint current file",
"type": "shell",
"command": "eslint",
"args": ["${file}"],
"group": "test",
"presentation": { "panel": "shared" }
}
]
}
调试时注意 cwd 和环境变量继承问题
任务默认在工作区根目录执行，但很多项目脚本（如 npm run build）依赖 package.json 位置和本地 node_modules。如果项目结构嵌套深（如 monorepo/packages/ui），直接在根目录跑 npm run build 会失败。
- 显式指定
"cwd": "${workspaceFolder}/packages/ui"，确保命令在正确子目录下执行 - 环境变量不会自动从 shell 继承（尤其 macOS/Linux 的
~/.zshrc），需在tasks.json中用"options.env"手动补全，例如"NODE_ENV": "development" - Windows 用户注意：CMD 和 PowerShell 对引号、转义处理不同，建议统一用
"type": "shell"并设"os": "win32"分平台配置
项目级任务真正的复杂点不在配置语法，而在于 cwd 是否精准、环境是否对齐、以及是否意识到 VSCode 的“工作区”就是你的项目边界——越想绕过它做全局复用，越容易掉进路径和变量的坑里。
