VSCode不原生支持保存即运行，需依赖扩展或外部工具：Auto Run Command适用于单次CLI操作，watchexec/nodemon/tsc --watch等工具实现真正的文件系统监听，VSCode仅作容器和展示层。

VSCode 本身不提供“保存即运行代码”的原生能力，所有自动执行都依赖外部工具或扩展介入。直接写个 tasks.json 并设 isBackground: true 不会自动监听文件——它只负责启动命令，不负责重试或响应变更。

Auto Run Command 扩展：保存时跑一条命令最轻量方案

适合 ESLint 修复、Prettier 格式化、生成文档这类单次 CLI 操作，不依赖构建工具链。

• 安装扩展 Auto Run Command（作者 Shan Khan）
• 在 settings.json 中加规则，例如保存 .ts 文件时自动修复：

  "autoRunCommand.rules": [
    {
      "command": "eslint --fix ${file}",
      "match": "\.ts$",
      "runIn": "terminal"
    }
  ]

• runIn: "terminal" 表示在集成终端中执行；设为 "none" 则静默运行（适合无输出的 CLI）
• ⚠️ 注意：它监听的是 onDidSaveTextDocument 事件，不是文件系统变更。Git checkout、脚本写入、IDE 外部修改都不会触发

chokidar-cli 或 watchexec：真正监听文件系统变更

当你需要响应任何来源的改动（比如构建脚本输出 CSS、Python 生成 JSON、Docker 写入日志），就必须绕过 VSCode 编辑事件，走底层监听。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 推荐用 watchexec：跨平台、无 Node.js 绑定、比 chokidar-cli 更稳定

  npm install -g watchexec

• 在 .vscode/tasks.json 中定义任务：

  {
    "label": "watch:build",
    "type": "shell",
    "command": "watchexec",
    "args": [
      "-w", "./src",
      "-e", "ts,js,json",
      "--on-change", "npm run build"
    ],
    "isBackground": true,
    "problemMatcher": []
  }

• -w 指定监听目录，-e 指定扩展名，--on-change 是触发命令（支持完整 shell 语法）
• Windows 用户若遇路径空格问题，建议用 PowerShell 或 Git Bash，并确保引号包裹：--on-change "npm run build"

tasks.json 配合 tsc --watch / nodemon：语言生态内建监听

TypeScript 和 Node.js 生态已有成熟监听机制，VSCode 只需正确托管，不需额外工具。

• 配置 tsc --watch 任务时，必须同时满足三项：
  • "isBackground": true
  • "problemMatcher": []（清空或删掉该字段，否则卡在“正在运行”）
  • "presentation": { "panel": "shared", "clear": true }（避免日志堆积）
• 对 Node.js 项目，nodemon app.js 同理：

  "command": "nodemon",
  "args": ["app.js"],
  "isBackground": true,
  "problemMatcher": []

• ⚠️ 不要指望 VSCode 自己轮询文件——isBackground: true 只是告诉编辑器“这命令不会退出”，监听逻辑仍在 tsc 或 nodemon 内部

WSL/Docker 环境监听失效？先调 files.useExperimentalFileWatcher

在 WSL2 或 Docker Desktop 挂载卷里，VSCode 常因路径解析失败漏监文件，典型表现是改 src/index.ts 没反应，但改 package.json 却能触发。

• 打开设置搜索 files.useExperimentalFileWatcher，勾选启用（或手动加到 settings.json）：

  "files.useExperimentalFileWatcher": true

• 必须重启 VSCode，热重载无效
• 若仍失效，检查 files.watcherExclude 是否过度过滤，尤其确认没把 **/src/** 误加进去
• 更稳妥做法：在 WSL 内终端直接运行 watchexec 或 nodemon，而非让 Windows 版 VSCode 直接监听远程挂载路径

真正起作用的监听永远不在 VSCode 进程里，而是在你启动的 CLI 工具（watchexec、nodemon、tsc --watch）中。VSCode 只是容器和展示层——这点容易被忽略，但决定了配置成败。