importlib.reload()报ImportError: module not in sys.modules，因模块未预先导入sys.modules；须先import或importlib.import_module()加载，再传模块对象而非字符串名调用reload。
热重载失败时 importlib.reload() 报错 ImportError: module not in sys.modules
直接调用 importlib.reload() 前，模块必须已通过 import 或 importlib.import_module() 加载进 sys.modules。如果只是改了文件但没首次导入，或用了相对导入/动态路径却没正确引用模块对象，就会触发这个错误。
实操要点：
- 先确保模块已被成功导入（例如执行过
import mymodule），再传入reload()的是模块对象，不是字符串名：importlib.reload(mymodule)，而非importlib.reload("mymodule") - 若模块是从子包中导入（如
from pkg.sub import mod），要 reload 的是顶层包或完整路径模块对象：importlib.reload(pkg.sub.mod)，而不是mod本身（它可能只是个别名） - 检查
sys.modules是否真有该键："mymodule" in sys.modules，没有就说明根本没加载过，得先import一次
修改后 reload 却没生效，变量/函数仍是旧版本
常见于模块内定义了全局变量、类实例、或被其他模块缓存了引用。reload 只更新模块的命名空间，不自动更新已有对象的引用或已绑定的方法。
典型陷阱：
立即学习“Python免费学习笔记（深入）”；
- 另一个模块做了
from mymodule import func，之后 reloadmymodule，但func还是旧函数对象——因为func是独立引用，和模块对象解耦了 - 模块里有个全局列表
cache = []，reload 后这个列表对象仍被保留（Python 不清空原模块对象的内存），新模块代码会重新执行赋值语句，但若写成cache.append(...)就会累积旧数据 - Jupyter 中多次运行
%run script.py不等于 reload；它每次都是新建命名空间，和importlib.reload()机制不同
在 Web 开发或长期运行服务中安全使用 importlib.reload()
生产环境几乎从不启用热重载，但本地调试 FastAPI/Flask 时有人尝试手动 reload 路由模块。这非常危险：HTTP 请求可能正在执行旧函数，而你同时 reload 了模块，导致字节码切换、装饰器失效、甚至解释器崩溃。
更稳妥的做法：
- 只对纯逻辑模块（无全局状态、不启动线程、不注册信号）做 reload，避开
app、db、cache等核心对象所在模块 - 配合
watchdog监听文件变化，但 reload 前加锁或暂停请求处理（比如用threading.Event控制） - 优先用官方热重载方案：FastAPI 的
--reload、Flask 的debug=True，它们底层用的是进程重启，比模块级 reload 更可靠
为什么不能 reload 内置模块或 C 扩展模块
importlib.reload() 明确禁止对内置模块（如 sys、builtins）和大多数 C 扩展模块（如 numpy、json）调用。C 模块的初始化逻辑通常只执行一次，reload 会跳过 PyInit_* 函数，导致模块状态不一致甚至段错误。
验证方式很简单：
- 执行
import json; importlib.reload(json)会报ValueError: cannot reload extension module json -
import sys; importlib.reload(sys)报ValueError: cannot reload built-in module sys - 只要模块的
__file__为None或路径以.so/.pyd结尾，基本都不可 reload
