热更新失效主因是sys.modules未清理或绕过——它是import强制开关，命中即返回旧模块；reload仅替换sys.modules值，不更新已有变量引用；手动pop+import易致模块错位；需同步清理依赖、上下文及.pyc缓存。
热更新失效，八成是因为 sys.modules 没被正确清理或绕过——它不是“可选缓存”，而是 Python 导入机制的强制开关。
sys.modules 是 import 的硬性拦截点
每次执行 import config，Python 不会先读文件，而是直接查 sys.modules['config']。命中就返回，不命中才走查找、编译、执行流程。这意味着：哪怕你改了 config.py 文件内容，只要 sys.modules['config'] 还在，后续所有 import config 都拿到旧对象。
这不是 bug，是设计：保证模块单例、避免重复初始化。但对热更新来说，它成了第一道墙。
reload() 只换引用，不碰已有变量
importlib.reload() 的行为很明确：用新模块对象替换 sys.modules 里的值，仅此而已。但它不管你的代码里已经存了什么：
立即学习“Python免费学习笔记（深入）”；
- 如果用了
from config import THRESHOLD，那这个THRESHOLD是个独立变量，指向旧模块里的旧值，reload()后它不会自动更新 - 如果某个类实例（比如
Model()）在旧模块里定义并创建，它的__class__仍指向旧类对象，方法调用不会走新逻辑 -
sys.modules里模块对象的__dict__被替换了，但旧对象还在内存里，没被 GC（因为可能还有其他引用）
手动 pop + import 容易导致模块对象错位
有人试过 del sys.modules['config']; import config，看似清空重来，但风险很高：
- 如果当前作用域已有
import config绑定的config名字，它仍指向旧模块对象（id 不变），而sys.modules['config']已是新对象 - 这种错位会让
importlib.reload(config)直接报错：ImportError: module config not in sys.modules - 更隐蔽的问题是：多个文件分别
import config，它们拿到的可能是不同版本的模块对象（取决于各自 import 时机）
真正要动的是模块加载链，不是单个缓存项
单纯操作 sys.modules 解决不了根本问题。热更新要生效，必须同时处理：
- 确保所有依赖该模块的地方，都通过模块名动态访问（如
config.THRESHOLD），而非提前解包（from config import THRESHOLD） - 清理所有持有旧模块对象的上下文：Flask 的
app.config、线程局部存储threading.local、全局单例类实例 - 如果模块内有 C 扩展或已编译的字节码（
.pyc），需同步清理对应缓存目录，否则importlib.reload()可能加载到旧字节码
最常被忽略的一点：热更新不是“改完就生效”，而是“改完后所有路径都重新走 import 流程”。只要有一处漏掉，旧逻辑就会卡在那里不动。
