Watchman：Meta 出品的文件监控服务，构建工具链的隐藏主力

做前端开发的人大概都遇到过这个场景：改了一行 CSS 或 JS，切到浏览器手动刷新看效果，一天来回几十次。Watchman 干的就是解决这类问题的活儿，监控文件变化，发现改动后自动触发对应操作。这工具在 Meta 内部跑了多年，后来整体开源了出来。

核心就两件事：监控文件，触发动作

Watchman 会递归扫描指定目录，精确记录每个文件的修改、创建、删除事件。和简单轮询文件系统的方式不同，它调用的是操作系统底层的文件通知机制，Linux 上是 inotify，macOS 是 FSEvents，Windows 是 ReadDirectoryChanges。监控几千个文件的时候，CPU 占用也几乎可以忽略。

文件发生变化后，Watchman 可以执行预设的命令。跑测试、重新编译、清缓存，都可以配上去。本质上它就是一个事件驱动的文件状态管理器。

为什么不只是用 chokidar 或 inotifywait

市面上做文件监听的工具不少，Watchman 区别于它们的地方有三个。

跨平台是一方面。一套 API 覆盖 Linux、macOS、Windows，项目组不用为不同系统写适配逻辑。

查询能力是另一方面。Watchman 不只是告诉你"文件变了"，它内部维护了一份文件状态快照，支持条件查询。比如"找出过去 5 秒内修改过的 .js 文件"或者"列出所有大于 1MB 的文件"，在大型项目里这类查询比简单的变更通知有用得多。

还有一点是经过了大规模验证。React 的开发工具链、Metro 打包器（React Native 的默认打包方案）都依赖 Watchman。Meta 内部每天处理的文件变更量级很大，这个工具的稳定性是在生产环境里锤出来的。

谁在用，Star 多少

Star 数 1.36 万，对一个底层基础设施类工具来说算是不错的成绩。核心用户群是大型项目的构建系统维护者，React 和 React Native 生态的开发者用得最多。

实际上手体验

安装不复杂。macOS 用 Homebrew，Linux 用系统包管理器，Windows 有预编译二进制包。客户端库提供了 Python、Rust、JavaScript 三种语言的选择，接入门槛不高。

不过也要说，如果你的项目只有几十个文件，操作系统自带的文件监听（比如 Node.js 的 fs.watch）基本够用。Watchman 真正有价值的场景是 monorepo，文件数量上万的时候，它的查询能力和资源控制优势才体现得出来。

MIT 协议开源，Meta 的源码管理团队在维护，短期内不用担心停更。

MIT 协议开源，Meta 的源码管理团队在维护，短期内不用担心停更。