VSCode tasks.json 中 command 路径错误会导致静默失败；args 需拆分传递避免空格/引号问题；label 重复会覆盖任务；需配置 problemMatcher 才能定位错误；环境差异需手动验证。
tasks.json 里 command 写错路径就根本不会执行
VSCode 的 tasks.json 不会自动帮你校验 command 是否存在，输错一个字母、少个 ./、或者用了 Windows 风格路径在 macOS 上跑，结果都是静默失败——终端不弹、没报错、任务显示“已完成”，其实啥也没干。
-
command必须是可执行文件的完整路径或命令名；如果是本地脚本，优先用./script.sh而不是script.sh - 跨平台时避免硬写
node_modules/.bin/tsc，改用npx tsc更可靠 - Windows 用户注意：PowerShell 默认禁用本地脚本执行，要么改执行策略，要么在
options.shell里指定cmd - 加
"isBackground": true前先确认命令真能后台运行（比如带--watch），否则任务卡住不结束
args 数组里空格和引号处理很反直觉
VSCode 把 args 当作字符串数组直接传给 shell，不会做额外解析。这意味着你写 "--outDir dist/js" 实际上传了两个参数：--outDir 和 dist/js；而 "--outDir=dist/js" 才是一个参数。
- 路径含空格？别拼字符串，拆成独立数组项：
"args": ["--outDir", "build/output with space"] - 需要 shell 特性（如
&&、管道、变量）？不能靠args，得把整条命令塞进command，并配"shell": true - Node.js 脚本传 JSON 参数？用
JSON.stringify()处理后再进args，否则引号嵌套容易崩
label 重复会导致 Ctrl+Shift+P 里只显示一个任务
VSCode 用 label 作为任务唯一标识。同 workspace 下多个 task 写了相同 label（比如都叫 build），快捷键调出的任务列表只会显示一个，另一个被覆盖——但它们仍可能在不同 dependsOn 关系里悄悄执行，造成行为混乱。
- 区分环境：用
build:dev、build:prod而非都叫build - 区分语言：TypeScript 项目里
tsc和swc编译任务 label 别都叫compile - 如果依赖其他 task，
dependsOn里写的必须是对方 exactlabel，大小写敏感，多一个空格都不行
没有 problemMatcher 就看不到编译错误定位
写了 command 和 args 只是让命令跑起来，但 VSCode 默认不知道输出里的 Error: ./src/index.ts(5,10): 这种行是什么意思。没有配置 problemMatcher，错误就只躺在终端里，没法点跳转、没法在 Problems 面板聚合、也没法触发保存时自动检查。
- TypeScript 推荐用内置
$tsc-watch或$tsc，别自己写正则匹配，除非你真要定制输出格式 - 自定义构建工具（比如 esbuild、vite build）需手动写
problemMatcher，重点匹配文件路径、行号、列号三要素，否则跳转失效 - 多个 matcher？用数组，但注意顺序：第一个匹配成功的就停止，后面的不生效
真正麻烦的不是写 tasks.json，而是它和终端实际执行环境的差异——PATH、shell 类型、当前工作目录、甚至 Node.js 版本，都可能让 task 表现和你在终端里敲的一样又不一样。每次改完建议右键菜单选「Run Task」再看终端输出的第一行 pwd 和 which node。
