全局变量在Python包中修改不生效，因__init__.py中变量非包级单例，多次导入可能创建不同模块对象；正确做法是将状态存于独立模块（如_state.py），并依场景选用module-level变量、threading.local或contextvars.ContextVar。
全局变量在 Python 包里为什么改了不生效？
因为 __init__.py 中定义的变量不是“包级单例”，每次 import 都可能触发新模块对象创建，尤其在热重载、多线程或子模块重复导入时，package.var 看似同一个名字，实则指向不同内存地址。
- 典型现象：在
mylib/__init__.py里写counter = 0，然后mylib.submod.inc()增加它，但主脚本再读mylib.counter还是 0 - 根本原因：Python 模块缓存（
sys.modules）按完整路径键入，mylib和mylib.__init__在某些导入方式下被视为不同模块 - 正确做法：把状态存在明确的、唯一可导入的模块中，比如统一放在
mylib/_state.py，所有地方都from mylib._state import counter
会话级持久化该用 module-level 变量还是 threading.local？
取决于“会话”指什么：如果是单进程内跨函数调用保持状态（如 CLI 工具一次运行中的配置），用模块级变量最轻量；如果是 Web 或异步场景需隔离用户/请求上下文，threading.local 或 contextvars.ContextVar 才安全。
-
threading.local：适合传统多线程服务，每个线程独立副本，但协程（asyncio）中不跨await边界 -
contextvars.ContextVar：推荐用于 asyncio 或混合环境，支持 async/await 传播，初始化必须用set()，读取用get()，不能直接赋值 - 别碰
globals()或sys._getframe()：不可靠、难测试、CPython 实现细节，上线后容易崩
如何让包变量在 reload 后不丢失？
Python 的 importlib.reload() 会重新执行模块代码，原有对象引用全部失效——这是设计使然，不是 bug。想保留状态，得把数据外置到模块作用域之外。
- 把关键状态存进
__builtins__（慎用）：__builtins__.mylib_session_id = uuid4()，重启解释器就丢，但跨 reload 存活 - 更稳方案：用文件或内存字典做外部存储，例如在
mylib/_cache.py里维护一个dict，key 是会话标识，value 是状态，reload 时查 key 恢复 - 绝对不要在
__init__.py里写if 'var' not in globals(): var = init()—— 多次 reload 会导致多次init()调用，逻辑错乱
Django/Flask 中怎么安全共享包级配置？
Web 框架本身已提供应用生命周期管理，强行在包里塞全局变量反而破坏框架约定，也难以配合 gunicorn 多 worker 部署。
- Django：把动态配置放
settings.py，运行时修改用django.conf.settings.configure()（仅限 startup 阶段），别碰myapp.config这类包变量 - Flask：用
app.config或扩展的init_app()注入，状态应绑定到current_app或g（请求周期）/app.extensions（应用周期） - 通用原则：跨请求的状态，必须走 Redis / 数据库；跨线程但同进程的状态，可用
contextvars+ app context 绑定；仅初始化用的配置，放pydantic.BaseSettings类里更清晰
真正麻烦的从来不是“怎么定义一个全局变量”，而是“谁在什么时候能看见它、改它、依赖它”。模块加载顺序、reload 行为、线程模型、框架生命周期——这些叠加起来，会让最简单的 var = [] 变成线上故障的种子。
