Metro启动反复出现Watchman Recrawl警告的永久解决办法咨询

问题背景 #

启动Metro（执行react-native start）时，反复出现以下Watchman警告：

warning: Watchman watch-project returned a warning: Recrawled this watch 11 times, most recently because:
MustScanSubDirs UserDropped
To resolve, please review the information on
https://facebook.github.io/watchman/docs/troubleshooting.html#recrawl
To clear this warning, run:
watchman watch-del '/path/to/my/project' ; watchman watch-project '/path/to/my/project'

执行提示的命令仅能临时消除警告，数小时或次日会再次触发。使用macOS 13.4，已为Watchman授予完整磁盘访问权限但无效，且从安全角度不希望赋予该权限；同时因React Native依赖Watchman，无法卸载。

问题根源 #

这个警告的核心原因是目录元数据频繁变更，触发Watchman重新扫描目录。常见诱因包括：

• macOS Spotlight索引项目目录
• 云同步工具（iCloud、Dropbox等）同步项目文件
• 安全软件定期扫描目录
• Watchman默认配置未过滤不必要的监控目录
• macOS FSEvents API的特性限制（对目录变更的敏感度较高）

永久解决步骤 #

1. 阻止Spotlight扫描项目目录 #

打开「系统设置」→「隐私与安全性」→「Spotlight」→「隐私」，点击加号添加你的React Native项目目录，阻止Spotlight索引该目录，避免元数据频繁变动。

2. 移除云同步目录中的项目 #

如果项目存放在iCloud/Documents等云同步目录中，将其移至非同步目录（如~/Developer）；或在云同步工具的设置中排除该项目目录，禁止自动同步。

3. 配置Watchman忽略冗余目录 #

在项目根目录创建.watchmanconfig文件，添加以下内容，让Watchman跳过无需监控的目录，减少扫描触发频率：

{
  "ignore_dirs": ["node_modules", ".expo", ".git", "ios/Pods", "android/build", "dist"]
}

可根据项目实际情况调整忽略列表。

4. 调整Watchman的磁盘访问权限 #

无需授予完整磁盘访问权限，只需在「系统设置」→「隐私与安全性」→「文件与文件夹」中，找到Watchman，勾选项目所在的具体目录（如Documents）即可。

5. 更新Watchman至最新版本 #

通过Homebrew执行命令更新：

brew update && brew upgrade watchman

新版本修复了部分macOS环境下的目录监控兼容性问题，能降低重扫概率。

为何问题长期存在？ #

Watchman依赖macOS的FSEvents API实现目录监控，而macOS系统自带的索引、云同步等工具会频繁修改目录元数据，加上不同开发者的环境差异（目录位置、同步工具、安全配置），很难推出通用的一键修复方案。同时React Native对Watchman的强依赖，使得用户无法规避该工具，导致问题持续出现。

内容的提问来源于stack exchange，提问作者Can Poyrazoğlu