Python原生不支持真正的模块热重载，因import后模块缓存在sys.modules中，后续导入直接复用旧对象；importlib.reload()仅更新模块本身，不修复已有引用。
Python本身不支持真正的模块热重载（即运行中无缝替换已导入模块的代码并更新所有引用），但可通过工具和约定实现“类热重载”效果，显著提升开发调试效率——关键不在技术多炫酷，而在减少手动重启、保持状态、快速验证逻辑。
为什么原生import不能“热重载”？
Python导入模块后，会将模块对象缓存到sys.modules字典中。后续import直接复用该对象，不会重新执行模块代码。即使你修改了.py文件，已加载的函数/类对象仍指向旧内存地址，新代码不会自动生效。
常见误区：用importlib.reload()看似能重载，但它只更新模块对象本身，不自动修复已有引用。例如：
import mymodule obj = mymodule.MyClass() # 创建旧版本实例 import importlib importlib.reload(mymodule) # 模块重载成功 print(obj.__class__ is mymodule.MyClass) # False！obj仍是旧类
实用热重载方案（按推荐度排序）
1. 使用 watchfiles + importlib.reload 自动触发
适合轻量脚本或本地调试，不依赖框架。
- 安装：pip install watchfiles
- 写一个 watcher.py，监听项目目录下.py文件变化，检测到改动后调用 reload()
- 注意：reload前需手动清理旧模块引用（如清空全局变量、重建实例），否则状态残留
2. 框架内建支持（最省心）
Django、FastAPI（配合uvicorn）、Streamlit 等主流框架都内置了热重载开关：
- Django：python manage.py runserver 默认开启
- Uvicorn：uvicorn main:app --reload
- Streamlit：streamlit run app.py 自动监听
原理是：框架启动子进程运行代码，文件变动时杀掉旧进程、拉起新进程——不是真正“热”，但体验接近，且自动处理状态隔离。
立即学习“Python免费学习笔记（深入）”；
自定义类热重载：适用于长期运行的服务逻辑
若你在写一个需要持续运行（如WebSocket后台、定时任务调度器）的程序，又想动态更新业务模块，可采用“插件式加载”设计：
- 把可变逻辑封装进独立模块（如handlers/notify.py）
- 主程序不直接import，而是通过importlib.util.spec_from_file_location动态加载
- 每次调用前检查文件修改时间，有更新则重新加载并替换内存中的handler对象
- 关键点：确保新旧模块接口一致，避免调用方崩溃
避坑提醒
- reload() 不会重置 C 扩展模块或已编译的 Cython 类
- 闭包内引用的旧函数不会自动更新，需显式重新绑定
- 多线程/多进程环境下 reload 可能引发竞态，不建议在生产使用
- IDE（如PyCharm）的“Reload changes”只是刷新编辑器视图，不影响解释器运行时
