tasks.json是VSCode中用于配置构建任务的JSON文件，仅在用户手动触发（如Ctrl+Shift+B）时读取并执行command和args，不自动运行；它必须位于工作区根目录的.vscode/tasks.json路径下，且需满足version为"2.0.0"、group:"build"、isBuildCommand:true等条件才能被识别。
tasks.json 不是“配完就自动跑”的开关，它只在你手动触发时才执行命令；所谓自动化，全靠 problemMatcher + isBackground + dependsOn 这三者的组合逻辑来实现。
tasks.json 放哪儿、叫啥名，VSCode 才认
VSCode 只读取工作区根目录下 .vscode/tasks.json 这一个文件。路径或文件名错一点，任务就彻底消失：
-
.vscode/tasks.json✅（唯一有效位置） -
task.json❌（少个 s） -
.vscode/tasks/tasks.json❌（多了一层目录） -
~/tasks.json❌（用户家目录不生效） -
src/.vscode/tasks.json❌（子文件夹里无效）
打开的是单个文件（没用「File → Open Folder」）？那 .vscode/ 下所有配置都不加载，Tasks 菜单直接为空。
为什么 Tasks: Run Task 里找不到你的 label
不是 VSCode 没刷新，而是配置没被识别为“可运行任务”。高频原因：
-
label里含空格或中文：比如"label": "npm build"，某些版本会解析失败；建议用短横线："label": "npm-build" - 漏了
"group": "build"或"isBuildCommand": true：Ctrl+Shift+B 只显示带group: "build"的任务 -
version写成"2.0"或2.0.0（没加引号）：必须是字符串"2.0.0" - 多根工作区下，你改的是非活动文件夹里的
tasks.json：只有当前焦点文件夹的配置生效
tsc --watch 为啥不报错也不跳转到错误行
因为 VSCode 默认把 tsc --watch 当作普通前台命令——输出红字只是文本，不解析、不定位。要让它真正“活”起来，必须同时满足：
Node.js 可靠编程
下载
Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词：Node.js 开发、async/await、流处理、性能优化、安全编码。
-
"isBackground": true：告诉 VSCode “这任务不会退出，持续监听” -
"problemMatcher": "$tsc-watch"：不是$tsc，后者只匹配一次性构建的错误格式 - 首次需手动运行一次任务：保存文件不会自动触发，除非你装了额外扩展（VSCode 原生不支持 runOnSave）
示例关键字段：
{
"label": "tsc-watch",
"type": "shell",
"command": "tsc",
"args": ["--watch"],
"isBackground": true,
"problemMatcher": "$tsc-watch"
}
npm run build 报 command not found 怎么办
VSCode 任务进程默认不加载你的 shell 配置（如 ~/.zshrc），也不继承项目级 Node.js 版本（nvm/volta 管理的）。直接写 "command": "npm" 极易失败。
- 推荐用
npx --no-install：例如"command": "npx", "args": ["--no-install", "tsc", "--build"] - 或指向本地二进制：
"command": "./node_modules/.bin/tsc"，绕过全局安装依赖 - 需要
.env变量？必须手动补"env"字段："env": { "NODE_ENV": "development" } - Windows 上跑 PowerShell 脚本？得显式指定：
"shell": { "executable": "pwsh", "args": ["-Command"] }
dependsOn 看似写了却并行执行？缺了 "dependsOrder": "sequence" 和显式 "isBackground": false（尤其对非监听类任务）。
最常被忽略的一点：VSCode 的 tasks.json 是纯转发器，它不解决环境、路径、权限问题——它只负责把你说的命令，在你说的环境下，尽可能忠实地敲进终端里。能不能跑通，取决于你是否把真实路径、真实权限、真实变量都塞进了配置里。
