如何在Python包中使用全局变量？包内全局变量失效问题求助

阿华AIGC实验室

2026-5-19

嘿，这个问题我之前帮好几个开发者捋清楚过——核心原因其实是Python模块的作用域和你在控制台里直接定义函数的作用域完全不是一回事！

为啥控制台能用，打包成包就不行？

当你在Python控制台里直接写函数时，函数里的global关键字绑定的是__main__模块（也就是你当前的交互式会话）的全局命名空间。但把函数打包成包后，每个.py文件都是一个独立的模块，它的“全局”变量其实是这个模块自己的私有命名空间里的，和主程序的全局命名空间完全不共享。说白了，你在包的函数里修改的“全局变量”，只是那个模块文件里的变量，主程序根本拿不到。

给你几个靠谱的解决方案，按推荐程度排序：

1. 彻底抛弃全局变量，用类封装状态（最推荐）

这是Python里管理共享状态的标准做法，代码更清晰、更容易维护，还能避免作用域混乱。比如原来依赖全局变量的两个函数，可以改成这样：

# my_package/core.py
class MyToolkit:
    def __init__(self):
        # 把原来的全局变量变成实例属性
        self.shared_obj = None
    
    def init_data(self):
        # 原来的func1，负责初始化对象
        self.shared_obj = {"user_id": 123, "username": "nate"}
    
    def process_data(self):
        # 原来的func2，依赖初始化后的对象
        if self.shared_obj is None:
            raise ValueError("先调用init_data初始化数据哦！")
        print(f"处理用户：{self.shared_obj['username']}")

使用的时候，只要创建类的实例，所有状态都会绑定在这个实例上：

from my_package.core import MyToolkit

tool = MyToolkit()
tool.init_data()
tool.process_data()  # 正常输出"处理用户：nate"

2. 让函数返回对象，由调用者管理状态

如果不想用类，最直接的方式就是让生成对象的函数把结果返回，然后调用者把这个对象传给需要它的函数。比如：

# my_package/func1.py
def create_shared_obj():
    # 原来的func1，直接返回生成的对象
    return {"user_id": 123, "username": "nate"}

# my_package/func2.py
def use_shared_obj(obj):
    # 原来的func2，直接接收传入的对象
    print(f"处理用户：{obj['username']}")

使用时显式传递对象，完全没有作用域问题：

from my_package.func1 import create_shared_obj
from my_package.func2 import use_shared_obj

my_obj = create_shared_obj()
use_shared_obj(my_obj)

3. 退而求其次：用模块级变量共享状态

如果你非要保留“全局”的感觉，可以把共享变量放在一个单独的模块里，其他函数通过导入这个模块来修改和访问它：

# my_package/shared.py
# 专门放共享变量的模块
shared_obj = None

# my_package/func1.py
from . import shared
def init_shared_obj():
    # 直接修改shared模块里的变量
    shared.shared_obj = {"user_id": 123, "username": "nate"}

# my_package/func2.py
from .shared import shared_obj
def process_shared_obj():
    print(f"处理用户：{shared_obj['username']}")

使用时要确保先调用初始化函数，再访问变量：

from my_package.func1 import init_shared_obj
from my_package.shared import shared_obj
from my_package.func2 import process_shared_obj

init_shared_obj()
process_shared_obj()  # 正常输出

⚠️ 注意：这种方式的模块级变量是单例的，如果你的包会被多线程或者多实例场景使用，可能会出现状态混乱，所以尽量谨慎使用。