fs.watch和 fs.watchFile有什么区别？

封面图 • 2025-11-29 • nodejs

`fs.watch` 和 `fs.watchFile` 是 Node.js 中用于监听文件或目录变化的两个不同方法，它们在功能、实现方式和使用场景上有一些关键区别。下面是它们的主要区别：

---

## 1. **`fs.watch()`**

### ✅ 特点：
- 使用 **原生操作系统 API**（如 Linux 的 inotify，macOS 的 kqueue，Windows 的 ReadDirectoryChangesW）来监听文件或目录的变化。
- **实时性强**，适用于需要高效监听大量文件或频繁变化的场景。
- 支持监听整个目录树（递归），但默认不递归，可以通过设置 `recursive: true` 来开启。

### 📌 示例：
```js
const fs = require('fs');

fs.watch('path/to/file', (eventType, filename) => {
  console.log(`文件 ${filename} 发生了 ${eventType} 变化`);
});
```

### ⚠️ 注意事项：
- 在某些系统上（如 Windows）可能需要安装额外的依赖（如 `chokidar`）才能获得更稳定的监听效果。
- 不支持所有平台（比如某些旧版系统可能不支持）。

---

## 2. **`fs.watchFile()`**

### ✅ 特点：
- 使用 **轮询机制**（polling）来检查文件是否发生变化。
- 不依赖操作系统级别的通知机制，因此兼容性更好。
- 对于小规模、不频繁的文件监控比较合适。

### 📌 示例：
```js
const fs = require('fs');

fs.watchFile('path/to/file', (curr, prev) => {
  console.log(`文件 ${curr.name} 发生了变化`);
});
```

### ⚠️ 注意事项：
- 轮询会带来一定的性能开销，不适合高频率或大规模的文件监控。
- 不能监听目录的变化（只能监听单个文件）。
- 如果你希望监听目录，可以结合 `fs.readdirSync()` 或 `fs.readdir()` 配合 `fs.watchFile()`，但这不如 `fs.watch()` 方便。

---

## 🔍 总结对比表

| 特性 | `fs.watch()` | `fs.watchFile()` |
|------|---------------|------------------|
| 实现方式 | 原生系统 API（inotify/kqueue/ReadDirectoryChangesW） | 轮询机制（polling） |
| 兼容性 | 依赖平台支持 | 更好，兼容性更强 |
| 监听范围 | 支持目录、文件，可递归 | 仅支持文件 |
| 实时性 | 高 | 低（取决于轮询间隔） |
| 性能 | 高（适合大量文件） | 低（适合少量文件） |
| 推荐使用场景 | 大量文件、实时监控 | 小规模、简单监控 |

---

## ✅ 推荐使用建议：

- 如果你需要监听一个目录及其子目录中的文件变化，并且对性能要求较高，推荐使用 `fs.watch()`。
- 如果你只需要监听一个文件，并且不需要特别高的实时性，或者你的环境不支持 `fs.watch()`，那么使用 `fs.watchFile()` 是一个稳妥的选择。

---

如果你需要更强大的跨平台文件监听功能，也可以考虑使用第三方库如 [**chokidar**](https://github.com/paulmillr/chokidar)，它封装了 `fs.watch()` 和 `fs.watchFile()`，并提供了更好的兼容性和功能。