怎样在 Python 包中全局初始化并共享变量

通过包级模块变量 + 显式初始化函数，可在整个包及其子模块中安全共享配置值，避免全局污染，同时确保初始化顺序可控。

通过包级模块变量 + 显式初始化函数，可在整个包及其子模块中安全共享配置值，避免全局污染，同时确保初始化顺序可控。

在 Python 包中实现跨模块的变量共享，关键在于明确变量的作用域归属和统一访问入口。直接在 __init__.py 中使用 global 声明无法使变量自动暴露给子模块（如 subpackage.my_function），因为每个模块拥有独立的命名空间。正确做法是：将共享变量定义为包的顶层模块属性，并通过包的 __init__.py 统一导出和管理。

✅ 推荐实现方式（结构清晰、符合 Python 惯例）：

1. 在 my_package/__init__.py 中定义变量与初始化函数：

   # my_package/__init__.pyx = None  # 占位符，表示未初始化；也可设为默认值（如 x = 0）

def init(initial_value):"""显式初始化共享变量 x"""global xx = initial_value

2. **在子模块中通过包名访问该变量（推荐）：**```python# my_package/subpackage/my_function.pyfrom .. import x  # 相对导入：从父包导入 xdef my_function():    if x is None:        raise RuntimeError("my_package.init() must be called before using this function")    print(f"Using shared value: {x}")    return x * 2

或使用绝对导入（更清晰、不易出错）：

# my_package/subpackage/my_function.pyimport my_packagedef my_function():    if my_package.x is None:        raise RuntimeError("my_package.init() must be called before using this function")    print(f"Using shared value: {my_package.x}")    return my_package.x * 2

3. 使用示例：

   # 主程序import my_packagemy_package.init(1234)

result = my_package.subpackage.my_function() # 输出: Using shared value: 1234 → 返回 2468

立即学习“Python免费学习笔记（深入）”；

⚠️ 注意事项：- ❌ 避免在 `__init__.py` 中直接执行 `init()`（如 `init(42)`），否则包导入即初始化，丧失控制权；- ❌ 不要依赖 `from my_package import x` 后再修改 `x`——这仅修改本地别名，不影响包内原始变量；- ✅ 若需类型提示或只读语义，可改用 `@property` 或 `types.SimpleNamespace` 封装；- ✅ 对于复杂状态，建议升级为单例类或依赖注入，而非裸变量。总结：Python 包的“全局变量”本质是**包模块的属性**，通过 `import my_package` 获取其命名空间后即可读写 `my_package.x`。配合显式 `init()` 函数，既保证了初始化意图明确，又实现了跨模块安全共享。