django runserver自动重载失效的根本原因是文件监控机制被干扰，如docker挂载、wsl2跨文件系统、ide安全写入或误用--noreload；默认statreloader仅轮询.py等特定文件，模板/环境变量等改动不触发重启，可改用watchdog提升可靠性或手动指定--extra-file。
为什么 runserver 不再自动重载代码改动
Django 的开发服务器默认启用热重载（auto-reload），但实际中常出现改了 views.py 或 models.py 后刷新页面没变化，必须手动 Ctrl+C 再重启。根本原因通常是文件监控机制被干扰——比如在 Docker 容器里挂载宿主机代码、使用 WSL2 且项目放在 Windows 文件系统、或启用了某些 IDE 的文件同步代理（如 PyCharm 的“safe write”）。
验证是否真失效：启动时留意终端输出是否有 Watching for file changes with StatReloader（旧版是 Auto-reloading is enabled）。如果没有，说明重载器根本没启动；如果有但不响应，才是监控失灵。
- 检查是否误加了
--noreload参数（常见于脚本或 IDE 运行配置） - 确认没有设置环境变量
DEBUG=False—— Django 2.2+ 要求DEBUG=True才启用重载 - Linux/WSL2 下若项目路径在
/mnt/c/...，StatReloader 无法监听文件系统事件，需移至~/project等原生路径 - PyCharm 用户关掉
Settings > System Settings > Use "safe write"，否则保存是先写临时文件再替换，StatReloader 捕获不到变更
用 inotify 替代 StatReloader 提升监听可靠性
默认的 StatReloader 是轮询检测文件修改时间（stat），效率低且易漏更。Linux/macOS 可换为基于 inotify（Linux）或 fsevents（macOS）的 WatchdogReloader，响应更快、更稳定。
安装依赖并指定重载器：
pip install watchdog python manage.py runserver --reloader-type watchdog
注意：
-
watchdog在 macOS 上依赖fsevents，安装时可能报错，用pip install watchdog --no-binary=watchdog可解决 - Windows 用户无需额外操作，默认已用
win32event实现类似效果 - 如果用 Docker，容器内需挂载
/dev/inotify（Linux）或确保宿主机共享文件夹支持 inotify 事件（Docker Desktop for Mac/Windows 默认不支持）
哪些文件改动不会触发重载
Django 的重载器只监控 Python 源文件（.py）、模板（TEMPLATES 配置中定义的目录）、静态文件（STATICFILES_DIRS）和部分配置项。以下改动**不会**触发重启，但会影响运行结果：
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 数据库迁移文件（
migrations/*.py）—— 改了也要手动python manage.py migrate - 环境变量（如
.env）或外部配置文件（settings.ini）—— Django 启动后才读取一次 - 前端构建产物（
dist/、build/）—— 需配合django-compressor或 webpack watch - Python 包安装/卸载（
pip install -e .）—— 必须重启才能加载新模块
想让非 Python 文件也触发重载？可手动指定额外路径：
python manage.py runserver --extra-file requirements.txt --extra-file config.yaml
Docker + Django 开发时热重载失效的典型修复
在 docker-compose.yml 中用 volume 挂载代码到容器，却始终不重载，大概率是文件系统事件未透传。Linux 主机上需确认内核支持 inotify 并增加限制：
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf sudo sysctl -p
Docker Desktop（Mac/Windows）用户则必须把项目移到 Linux 子系统或容器卷内部（如 /app），避免挂载 C:\ 或 /Users/ 下的路径。若必须用宿主路径，可退而求其次，在容器内启用 stat 模式并调高轮询间隔：
python manage.py runserver --reloader-type stat --reloader-interval 1
这个间隔单位是秒，设太小会吃 CPU，设太大又感知延迟——1 秒是多数场景下的平衡点。
重载不是魔法，它依赖底层文件系统通知或周期性扫描；当路径跨层、权限受限、或文件被代理写入时，就容易断连。比起反复调试，更稳妥的做法是：开发阶段坚持用原生文件系统路径 + watchdog，上线前再切回标准流程。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
