Node.js 怎么用 fs.watch 监听文件变化？

Question

仓乃文 · Accepted Answer

开发工具、构建系统需要监听文件变化自动执行操作。fs.watch 监听文件或目录的修改、创建、删除事件，实现自动重启、热更新、自动编译等功能。

监听单个文件：
```javascript
const fs = require("fs");

fs.watch("config.json", (eventType, filename) => {
  console.log(`${filename} 发生 ${eventType} 事件`);
  if (eventType === "change") {
    const config = JSON.parse(fs.readFileSync("config.json", "utf8"));
    console.log("配置已更新:", config);
  }
});
```

监听目录递归（Node.js 14.14+）：
```javascript
fs.watch("./src", { recursive: true }, (eventType, filename) => {
  console.log(`${filename} ${eventType}`);
  // 自动触发编译
  rebuild();
});
```

使用 fs.watchFile 轮询（兼容性更好）：
```javascript
fs.watchFile("data.json", { interval: 1000 }, (curr, prev) => {
  if (curr.mtime !== prev.mtime) {
    console.log("文件已修改");
  }
});

// 停止监听
fs.unwatchFile("data.json");
```

补充说明：
- fs.watch 基于 OS 原生事件，性能好但各平台行为有差异
- fs.watchFile 基于轮询，兼容性好但性能差，适合少量文件
- recursive 选项在 Linux 上不支持，macOS 和 Windows 支持
- 同一次修改可能触发多次回调，需要防抖处理
- 推荐用 chokidar 库处理生产环境的文件监听需求