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

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

fs.watch 与 fs.watchFile 都是 Node.js 用于监听文件变化的 API，但实现机制、性能、可用性差异明显。

来源整理自：vue3js.cn 面试官系列

1. 简述

fs.watch：基于操作系统的文件系统通知机制（如 Linux inotify、macOS FSEvents、Windows ReadDirectoryChangesW），事件触发即时。
fs.watchFile：使用轮询（默认每 5 秒检查一次文件的 mtime/ctime/atime/size），跨平台一致但性能较差。

2. 背景知识

Node.js 的 fs 模块负责与文件系统交互；不同操作系统对"文件变化通知"的原生支持差异很大，因此 fs.watch 在不同平台上的事件类型、可靠性也不一致（曾长期被列入"稳定性：1 - 实验性"）。fs.watchFile 通过定期 stat 实现跨平台一致性。

3. 解析

（1）工作原理

fs.watch：基于操作系统的文件系统通知机制，比如在 Linux 上使用 inotify，在 macOS 上使用 FSEvents。当文件系统发生变化时，操作系统会直接通知 Node.js 进程，进而触发相应的回调函数。

fs.watchFile：通过定期轮询文件的状态（如文件的修改时间、大小等）来检测文件是否发生变化。它不依赖于操作系统的文件系统通知机制。

（2）事件触发

fs.watch：能更及时地捕获文件系统的变化，因为它依赖于操作系统的实时通知。它会触发多种事件，如 change、rename 等，可用于监控文件或目录的重命名、创建、删除等操作。

fs.watchFile：事件触发相对滞后，因为它是通过轮询实现的。它主要触发 change 事件，用于检测文件内容或属性的变化。

（3）性能特点

fs.watch：性能较高，因为它依赖操作系统的通知机制，不需要频繁轮询，对系统资源的消耗较小。但它可能在某些文件系统或跨平台环境下存在兼容性问题。

fs.watchFile：性能较低，由于需要定期轮询文件状态，会消耗更多的系统资源，尤其是在需要监控大量文件时。不过它的兼容性较好，几乎可以在所有的文件系统上使用。

（4）使用场景

fs.watch：适用于需要实时响应文件系统变化的场景，如开发实时编译器、文件同步工具等。

fs.watchFile：适用于对实时性要求不高，更注重兼容性的场景，或者在某些不支持操作系统文件系统通知机制的环境中使用。

补充

补充：典型用法 + 注意事项。

const fs = require('node:fs');

// fs.watch：基于操作系统通知，事件更即时
const watcher = fs.watch('./src', { persistent: true }, (eventType, filename) => {
  console.log(eventType, filename);
});
// 记得在不需要时关闭，否则会一直持有句柄
// watcher.close();

// fs.watchFile：轮询实现，跨平台一致
fs.watchFile('config.json', { interval: 5000 }, (curr, prev) => {
  if (curr.mtimeMs !== prev.mtimeMs) console.log('changed');
});
// fs.unwatchFile('config.json');