已安装Watchman和pywatchman，Django仍用StatReloader求助

架构老林

2026-8-6

解决Django未启用WatchmanReloader及设置重载延迟问题

排查与修复步骤

检查Watchman服务状态
运行以下命令确认Watchman是否正常运行：
```
watchman version
watchman watch-list
```
如果watch-list返回错误，说明Watchman服务未启动或异常，执行watchman shutdown-server后重新启动服务。
验证pywatchman安装环境
确保pywatchman安装在当前项目的虚拟环境中，进入venv后执行：
```
import watchman
print(watchman.__version__)
```
若报错，重新安装pywatchman：
```
pip install pywatchman==1.4.1
```
修正.watchmanconfig语法错误
你的配置文件最后一个元素存在多余逗号，会导致JSON解析失败，修改为：
```
{"ignore_dirs": [".git", ".vscode", "venv", "htmlcov", "media"]}
```
启用调试日志排查检测失败原因
启动runserver时设置环境变量查看调试信息：
```
DJANGO_WATCHMAN_DEBUG=1 python manage.py runserver
```
输出日志会显示Django尝试加载WatchmanReloader的细节，根据错误提示定位问题（如权限不足、路径错误等）。
手动指定WatchmanReloader
若自动检测失效，启动时强制指定reloader：
```
python manage.py runserver --reloader=watchman
```
同时在项目settings.py中添加配置设置7秒重载延迟：
```
WATCHMAN_RELOADER_TIMEOUT = 7
```
检查版本兼容性
确认Django 4.1.2与Watchman 20221225版本兼容，若仍有问题，可尝试升级Django到4.2.x版本（需确认项目兼容性）。