Django StatReloader无法检测HTML文件变更不自动刷新如何解决

修复方案 #

• 先做浏览器强制刷新：按下Ctrl+Shift+R（Mac为Cmd+Shift+R）跳过本地缓存拉取最新页面，排除浏览器缓存导致的变更不展示问题。
• 确认settings.py中DEBUG参数值为True：Django仅在调试模式下默认开启模板、静态文件的自动重载能力，生产模式（DEBUG=False）下默认关闭所有重载逻辑。
• 检查缓存相关配置：如果配置中引入了全站缓存中间件、模板缓存加载器，会导致Django优先读取缓存的模板内容，不会读取修改后的本地文件，临时注释掉缓存相关配置即可恢复。
• 修复文件监听失效问题：Windows、WSL、共享目录环境下经常出现原生文件监听失效的问题，可改用轮询模式启动服务：python manage.py runserver --reloader=poll，兼容性更强。
• 核对模板文件路径：你当前配置的模板加载路径为项目根目录下的templates文件夹、以及所有已注册APP的templates子目录，确认你修改的HTML文件属于上述路径范围，否则Django不会加载修改后的文件。

第三方增强工具 #

如果需要更高的重载效率、甚至修改后自动刷新浏览器，可使用django-browser-reload工具，配置流程如下：

1. 安装依赖：pip install django-browser-reload
2. 在settings.py的INSTALLED_APPS列表中添加'django_browser_reload'
3. 在settings.py的MIDDLEWARE列表首位添加'django_browser_reload.middleware.BrowserReloadMiddleware'
4. 重启开发服务即可生效，后续修改模板、静态文件后浏览器会自动刷新展示最新内容。

内容的提问来源于stack exchange，提问作者Dariun