VS Code任务系统仅封装命令而不执行构建，核心配置文件是工作区根目录下的.vscode/tasks.json，需设version为"2.0.0"、task含label/type/command/args/group:"build"才能被Ctrl+Shift+B识别。
VS Code 任务系统本身不执行构建，它只是把你的命令（比如 tsc、npm run build、make）包装成可触发、可监听、可集成的流程。能不能自动化，取决于你有没有定义清楚「要跑什么」和「什么时候跑」。
怎么写一个能被 VS Code 识别的任务
核心是 .vscode/tasks.json 文件，必须放在工作区根目录。VS Code 不会自动发现任意脚本，只认这个路径下的配置。
- 最简结构必须包含
version（固定为"2.0.0"）、tasks数组 - 每个
task至少要有label（你在命令面板里看到的名字）和type（"shell"或"process"） - 用
command指定实际执行的程序，比如"tsc"；用args传参，比如["--build", "tsconfig.json"] - 别漏掉
group：设为"build"才能被Ctrl+Shift+B快捷键识别
为什么保存后 Ctrl+Shift+B 没反应
常见原因不是配置写错了，而是 VS Code 没法确定「该运行哪个任务」。
- 如果
tasks.json里有多个group: "build"的任务，它会弹出列表让你选；但如果你没设group，或者设成了"test"，快捷键就直接失效 - 检查终端是否在「集成终端」里启动：VS Code 任务默认复用当前终端，如果终端被手动关了或切到其他 profile，任务可能静默失败
- Windows 用户注意：
command写"npm"可能找不到，得写全路径或改用"shell"类型 + 显式调用cmd /c npm run build
如何让任务在保存时自动触发
VS Code 原生不支持「保存即运行」，但可以用「问题匹配器 + 监视模式」逼近这个效果。
- 先确保工具本身支持监视，比如
tsc --watch、webpack --watch、rollup -w - 在
tasks.json中添加"isBackground": true，并配好"problemMatcher"（例如"$tsc-watch"），否则 VS Code 会等进程退出才认为任务结束 - 保存任务后，用
Terminal > Run Task启动它；之后编辑文件，只要工具输出符合匹配器规则的错误行，问题面板就会实时更新 - 别依赖「自动保存 + 自动构建」闭环：VS Code 不监听文件系统事件来触发任务，那是构建工具或插件（如
Code Runner）的事
调试构建失败时该看哪里
任务失败通常不报错，只显示「终端已退出，退出代码: 1」——真正线索藏在细节里。
- 打开集成终端，点右上角「…」→「Select default profile」，确认 shell 环境和你在命令行里一致（尤其 Node.js 版本、PATH）
- 在
tasks.json中加"presentation": { "echo": true, "reveal": "always", "panel": "new" }，强制每次新开终端，避免旧环境残留干扰 - 如果命令含空格或特殊字符（比如路径带中文），
command必须用完整路径，且args单独拆开，不要拼成一整个字符串 - 某些 CLI（如
pnpm）在非交互式终端中行为不同，可尝试加"--no-interactive"或换用"shell"类型绕过
任务系统真正的复杂点不在语法，而在于它和 shell 环境、构建工具生命周期、VS Code 终端状态三者的耦合。调不通时，先在外部终端手动跑一遍 command 和 args 拼出来的完整命令，再回来比对。
