Ubuntu inotify 可监控文件数量与调整方法
核心结论
- 在 Ubuntu 上，inotify 的可监控上限由内核参数 fs.inotify.max_user_watches 决定。许多发行版（含 Ubuntu）的历史默认值为 8192；较新内核（≥ 5.11）会依据内存动态设定默认值，范围约为 8192–1048576。不少文档与实践将 524288 作为常用的安全上限。单个 inotify watch 的内存开销约为 ~1 kB（64 位），因此将上限设为 524288 大致会占用 ~512 MB 内存。实际可用上限还受 max_user_instances 与 max_queued_events 影响。
查看与调整方法
- 查看当前限制
- 当前用户可监控数量：cat /proc/sys/fs/inotify/max_user_watches
- 实例与队列上限：cat /proc/sys/fs/inotify/max_user_instances；cat /proc/sys/fs/inotify/max_queued_events
- 临时调高（立即生效，重启后失效）
- sudo sysctl fs.inotify.max_user_watches=524288
- 永久调高
- Ubuntu 推荐写入 /etc/sysctl.conf：echo “fs.inotify.max_user_watches=524288” | sudo tee -a /etc/sysctl.conf
- 使配置生效：sudo sysctl -p
- 提示
- 若监控大量文件/目录，必要时同步评估并适度调高 max_user_instances 与 max_queued_events，以避免事件堆积或创建 inotify 实例失败。
常见现象与建议值
- 出现错误提示如 “Visual Studio Code is unable to watch for file changes in this large workspace” 或 “inotify_add_watch: No space left on device”，通常意味着 max_user_watches 不足，按上文方法调高即可。
- 经验值
- 小型到中型项目：16384–81920
- 大型项目或 IDE 工作区：524288
- 内存预算估算：上限值 × ~1 kB（64 位）≈ 占用内存。例如 524288 个 watch ≈ 512 MB。在内存紧张环境下可适当降低上限，或精简监控范围（避免递归监控 node_modules、缓存、构建产物等无关目录）。