tasks.json必须严格置于工作区根目录的.vscode/tasks.json路径下，命名不可为task.json或嵌套于子文件夹；否则vscode完全不识别，tasks: run task菜单为空。
tasks.json 放错位置或命名错误，任务根本不会被识别
VSCode 只读取工作区根目录下 .vscode/tasks.json 这一个文件。不是 task.json，不是 .vscode/tasks/tasks.json，也不是子文件夹里的同名文件。多层嵌套或重命名后，Ctrl+Shift+P → Tasks: Run Task 列表里就彻底消失。
常见错误现象：
-
Tasks: Run Task菜单为空，或只显示npm: xxx却没有你自定义的 label - 手动运行
tsc --build成功，但 VSCode 里点不动 - 改了配置反复保存，终端没反应——先检查文件路径和名字是否严格匹配
为什么 tsc --watch 不报错却无法跳转到错误行
核心问题在于：VSCode 默认把 tsc --watch 当作普通前台命令执行，输出红字只是文本，不解析为“可定位问题”。必须配 problemMatcher + isBackground: true 才能激活错误高亮和 F8 跳转。
实操建议：
- 在任务中显式写
"isBackground": true，否则 VSCode 认为它结束了，后续输出就不捕获 -
"problemMatcher": "$tsc-watch"是 TypeScript 官方推荐匹配器，别用"$tsc"（那是给一次性编译用的） - 首次启动需手动运行一次任务；
--watch模式不会自动触发，保存后也不会构建，除非你配了runOnSave类扩展（VSCode 原生不支持）
npm run build 报 command not found？环境变量没继承
VSCode 的任务进程默认不加载你的 shell 配置（比如 ~/.zshrc），也不自动使用项目级 Node.js 版本（如 nvm 或 volta 管理的版本）。直接写 "command": "npm" 很可能找不到命令，或调用到系统全局的旧版 Node。
可靠做法：
- 改用
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 写了却还是并行执行？缺了 sequence 和 isBackground 控制
VSCode 的 dependsOn 默认只控制启动顺序，不等前一个结束就开下一个。尤其当依赖项是 tsc --watch 或 webpack serve 这类长期运行的任务时，后续部署任务大概率在构建完成前就冲进去了。
关键修复点：
- 必须加
"dependsOrder": "sequence"，否则dependsOn形同虚设 - 每个被依赖的任务都要明确
"isBackground": false（前台任务），否则 VSCode 不知道它啥时候“真正结束” - 如果依赖的是监听类任务（比如 watch），得配
problemMatcher并确保它能发出endOfLine信号，否则 VSCode 会一直等下去 - 示例片段中漏掉
"dependsOrder"是最常被忽略的硬伤
复杂点不在语法本身，而在于 VSCode 对“任务生命周期”的判断逻辑——它不看进程是否真在跑，只看有没有收到结束信号或匹配器声明的终止模式。watch 类任务最容易卡在这一步。
