VS Code任务系统仅封装命令，不执行构建或测试；需在工作区根目录配置.vscode/tasks.json，version必须为"2.0.0"，type推荐"shell"，command仅填可执行文件名，参数全放args数组。
VS Code 的任务系统本身不执行构建或测试，它只是把命令包装成可触发的快捷入口——真正起作用的是你配置的 command 和 args，背后调用的仍是终端里能跑起来的工具（比如 tsc、npm test、python -m pytest）。
怎么写一个能运行的 tasks.json？
VS Code 任务必须放在工作区根目录下的 .vscode/tasks.json 里。它不是脚本，而是声明式配置，核心字段是 version、tasks 和每个 task 的 label、type、command。
-
version必须是"2.0.0"（旧版"0.1.0"已弃用，不支持现代功能） -
type填"shell"（推荐）或"process"；前者走系统 shell（支持&&、|等），后者更轻量但无管道能力 -
label是你在Ctrl+Shift+P → Tasks: Run Task里看到的名字，要简洁明确，比如"build:ts"而不是"do build" -
command必须是可执行文件名或路径，不能带参数；参数全得塞进args数组里
{
"version": "2.0.0",
"tasks": [
{
"label": "test:unit",
"type": "shell",
"command": "npm",
"args": ["test", "--", "--watchAll=false"],
"group": "test",
"presentation": {
"echo": true,
"reveal": "always",
"panel": "shared",
"showReuseMessage": true
}
}
]
}
为什么 npm script 跑得好好的，tasks.json 里却报 command not found？
常见于 macOS/Linux 下用 zsh/bash，或 Windows 用 PowerShell —— VS Code 默认不读取你的 shell 配置（~/.zshrc、$PROFILE），所以 npm、pnpm、poetry 这类靠 shell 初始化加载的命令找不到。
- 最稳解法：用绝对路径，比如
/opt/homebrew/bin/pnpm或${env:USERPROFILE}\\AppData\\Roaming\\npm\\jest.cmd - 次选：在
tasks.json里加"options": {"shell": {"executable": "/bin/zsh", "args": ["-i", "-c"]}}，强制启动交互式 shell（注意性能略低） - 别写
"command": "pnpm run build"——command只认二进制名，空格后全是args，否则会当成一个叫"pnpm run build"的命令去搜
如何让构建失败时自动停止、测试失败时不关闭终端？
靠 isBackground 和 problemMatcher 配合。后台任务（如监听文件变化）需显式声明，否则 VS Code 会等命令退出才响应；而错误捕获依赖正则匹配输出，否则“失败”只体现在退出码，UI 不报错。
-
"isBackground": true后，必须配"problemMatcher"，否则任务永远显示“正在运行” - 常用内置 matcher：
"$tsc"（TypeScript）、"$eslint-stylish"、"$pytest"；自定义就写owner+pattern正则 -
"group": "build"或"group": "test"可让任务归类，并支持一键运行整组（Tasks: Run Build Task） - 想失败后停住终端看日志？设
"presentation": {"close": false}，别用true（默认就是关）
能不能一个任务链式执行多个命令？
可以，但别在 command 里拼 && 或 ; —— 这属于 shell 行为，必须用 "type": "shell"，且确保 args 整体传给 shell 解释。
- 正确写法：
"command": "sh", "args": ["-c", "tsc && python -m pytest tests/"] - 错误写法：
"command": "tsc && pytest"（会被当做一个命令名去找） - 更健壮的做法是封装进 npm script 或 Makefile，然后在 task 里调它：
"command": "npm", "args": ["run", "ci"] - 注意：链式执行无法单独中断中间步骤，出错就全停；真要分步控制，得拆成多个 task 并用扩展（如
multi-command）编排
任务系统真正的复杂点不在语法，而在环境一致性 —— 你本地 terminal 能跑的命令，VS Code 未必能，因为它不共享 shell 初始化逻辑。每次配完记得在集成终端里手动试一遍 which xxx 和 xxx --version，比反复改 tasks.json 更省时间。
