为什么Python的watchdog包在WSL2环境下无法监控部分文件夹？

问题排查步骤 #

1. 验证目标路径有效性与权限 #

• 首先确认./build/result/路径真实存在，可在当前脚本运行目录执行以下命令验证：

ls ./build/result/

若路径不存在，watchdog不会主动抛出异常，会静默导致监控失效，需要先手动创建目标目录再运行脚本。

• 验证运行脚本的用户对该目录有读、执行权限：

ls -ld ./build/result/

如果权限不足，可执行sudo chmod +rx ./build/result/赋权后重试。

2. 调整WSL2的inotify配额限制 #

WSL2默认对单个用户可添加的inotify监控数量有上限（默认值通常为8192），配额耗尽后新的监控会静默失败。

• 查看当前配额：

cat /proc/sys/fs/inotify/max_user_watches

• 临时调大配额：

sudo sysctl fs.inotify.max_user_watches=524288

• 永久生效：将fs.inotify.max_user_watches=524288写入/etc/sysctl.conf文件，执行sudo sysctl -p加载配置。

3. 规避跨文件系统监控缺陷 #

如果你的项目目录位于WSL2挂载的Windows磁盘路径下（即路径前缀为/mnt/c/、/mnt/d/等），WSL2的inotify机制对NTFS文件系统的支持存在已知缺陷，常出现子目录监控失效的问题。
解决办法是将整个项目迁移到WSL2原生Linux文件系统路径下（通常为/home/你的用户名/目录下），再运行脚本测试。

4. 确认监控范围与操作场景匹配 #

• 你的代码中recursive参数设置为False，此时只能捕获./build/result/根目录下的文件变动，如果你修改的是该目录下子目录内的文件，需要将recursive参数改为True。
• 修改文件的操作尽量在WSL2终端内执行，如果你在Windows系统中修改挂载路径下的文件，WSL2的inotify可能无法收到变更通知，可执行以下命令手动触发变更测试：

touch ./build/result/test_watchdog.txt

内容的提问来源于stack exchange，提问作者Bai-Zhan