vscode保存时自动运行脚本本质是监听save事件并触发task，需在tasks.json中配置"type"、"runon": "save"和"group": "build"/"test"三项核心字段，缺一不可。
保存时自动运行脚本，本质是监听 save 事件并触发 task
VSCode 自身不直接支持“保存即执行”，但通过 tasks.json 配合 "runOn": "save" 可以逼近这一效果。关键在于：必须用 type: "shell" 或 type: "process" 定义任务，且该任务需可被 VSCode 识别为“可后台运行、不阻塞编辑器”的轻量任务。如果任务启动后立即退出（比如单次 node index.js），VSCode 会认为它已完成；若需持续监听（如 nodemon），则必须设为 "isBackground": true 并配好 "problemMatcher"，否则任务会卡住、无法响应下一次保存。
tasks.json 中必须配置的三项核心字段
缺一不可，否则 runOn: save 不生效或报错：
-
"type": "shell"（推荐）或"type": "process"——"type": "shell"更兼容跨平台命令，"type": "process"在 Windows 上有时因路径空格出问题 -
"runOn": "save"—— 必须写在 task 外层（同级于label、type），不是放在options里 -
"group": "build"或"group": "test"—— VSCode 只对属于内置 group 的 task 启用runOn，自定义 group 名无效
常见失败原因：命令没找到、路径不对、权限不足
典型错误现象：Command failed with exit code 127（Linux/macOS）或 "xxx" 不是内部或外部命令（Windows），说明 shell 找不到可执行文件：
- 不要写
"command": "npm run dev"——npm在某些终端环境（尤其 macOS GUI 启动的 VSCode）可能不在$PATH中；改用绝对路径如/usr/local/bin/npm，或用bash -c "npm run dev" -
"args"中避免相对路径如"./src/index.ts"—— task 默认工作目录是打开的文件夹根目录，但若你从子文件夹保存，VSCode 不会自动切工作目录；统一用"${fileDirname}"或"${workspaceFolder}"显式指定 - Windows 用户执行
python报错？确认是否安装了 Python Launcher（py.exe），或改用"command": "py"并加"args": ["-u", "${file}"]
多个保存触发任务时的并发与覆盖行为
VSCode 默认不会排队或去重：快速连按 Ctrl+S 三次，会启动三个并行进程。这在跑 tsc 或 eslint 时容易冲突或报错：
- 加
"presentation": { "echo": false, "reveal": "never", "focus": false, "panel": "shared", "showReuseMessage": true }—— 避免弹窗干扰，复用同一个终端面板 - 用
"isBackground": true+"problemMatcher"是唯一能“感知运行中状态”的方式；例如nodemon启动后输出Starting...，匹配该 pattern 后 VSCode 就知道任务已在运行，下次 save 会先终止旧进程再启新 - 真正需要串行执行（如构建 → 测试）？别用
runOn: save，改用插件如multi-command或写一个 wrapper 脚本控制生命周期
最易被忽略的是 problemMatcher 对后台任务的必要性——没有它，VSCode 无法判断任务是否还在跑，也就没法做终止/重启。哪怕只是简单 node 脚本，也建议加上基础 matcher，比如 "$tsc" 或自定义空 matcher："problemMatcher": []（显式声明，避免 fallback 行为）。
