模块级变量在首次import时初始化并绑定到模块对象，生命周期与模块一致；多次import不重复执行，热重载或循环导入易致状态残留或未定义错误，需谨慎管理。
模块加载时变量就初始化了
Python 模块级变量在模块首次被 import 时执行赋值语句，此后只要模块对象还驻留在 sys.modules 中，变量就一直存在。这不是“全局变量”的那种动态生命周期，而是绑定在模块对象上的静态属性。
常见错误现象：ImportError 后重试却没重新初始化变量；热重载（如 Flask debug 模式）下变量值“残留”，导致逻辑错乱。
- 模块只加载一次，
import多次不会重复执行顶层代码 - 若需重置，得手动删
sys.modules['mymodule']再 import，但不推荐用于生产 - 变量初始化依赖的外部资源（如文件、数据库连接）若在首次导入时失败，整个模块加载会中断，后续 import 直接报
ModuleNotFoundError
变量值可被外部修改，且影响所有引用处
模块级变量是可变对象（如 list、dict、自定义类实例）时，任何地方对它的原地修改（.append()、['key'] = val）都会反映到所有导入该模块的地方——因为大家共享同一个对象引用。
使用场景：配置缓存、单例式连接池、计数器等轻量状态共享。
立即学习“Python免费学习笔记（深入）”；
- 用
const = 42这种不可变赋值，不能防止被重新赋值（mymodule.const = 99仍合法） - 想真正“只读”，得用
__all__配合文档约定，或封装成函数返回副本（def get_config(): return CONFIG.copy()） - 多线程下无锁修改可变模块变量会导致竞态，不是线程安全的默认行为
循环导入时变量可能为 None 或未定义
当两个模块互相 import，且其中一个在导入过程中访问另一个模块的变量，就可能拿到不完整状态：变量尚未执行到赋值语句，值为 None，甚至触发 NameError。
错误信息示例：NameError: name 'SOME_VAR' is not defined，发生在模块 A 的顶层代码中引用了正在导入中的模块 B 的变量。
- 避免在模块顶层直接使用其他模块的变量，改用函数内延迟访问
- 把变量初始化挪到函数里（懒加载），比如
def get_client(): global _client; if _client is None: _client = init(); return _client - pylint 会报
cyclic-import警告，但实际崩溃往往发生在运行时，而非 import 阶段
reload() 不重置所有变量状态
调用 importlib.reload() 会重新执行模块顶层代码，但已有对象的引用关系不会自动更新。如果其他模块已保存了旧模块里的变量引用（尤其是可变对象），那些引用仍指向原来的内存地址。
性能影响：reload 是开发调试手段，CPython 中它不释放旧模块对象，反复 reload 可能导致内存缓慢增长。
-
reload()后，新旧模块对象并存，id(mymodule.var)可能变化，但其他地方持有的old_module.var仍是原对象 - 类定义会被替换，但已创建的实例仍属于旧类（
isinstance(inst, mymodule.MyClass)返回 False） - 函数对象也会被替换，但闭包中捕获的旧模块变量不会自动刷新
sys.modules 就很难干净退出。最易被忽略的是：你以为改了变量，其实只是改了某个引用；你以为 reload 重来了，其实老对象还在内存里等着拖慢你。 
