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”只是刷新编辑器视图，不影响解释器运行时