Python函数内怎么使用global关键字修改全局变量

在 Python 中，如果在函数内部直接对外部已有的变量进行赋值操作，解释器默认会把该变量识别为当前函数的局部变量，不仅无法真正修改外部变量，往往还会引发 UnboundLocalError 报错。想要在函数体内对全局变量进行重新赋值或累加更新，核心做法是在函数体起始处、执行赋值动作前，使用 global 变量名 进行显式声明。

一、快速上手：使用 global 的标准步骤

使用 global 关键字的核心逻辑非常直观：它告诉 Python 编译器“在这个函数内部出现的这个变量名，不是函数的局部变量，而是属于顶层模块的全局变量”。

完成一次规范的全局变量修改，通常包含以下四个环节：

1. 外部定义全局变量：在函数体之外先声明该变量并设定初始值。
2. 函数内使用 global 声明：在函数内部的顶部，写明 global 变量名。
3. 对变量执行赋值操作：正常进行赋值、自增或计算覆盖。
4. 调用函数并验证结果：执行函数后，在外部打印该变量确认数值已更新。

下面是一个可直接运行的基础示例：

# 1. 外部定义全局变量
total_score = 100

def increase_score(points):
    # 2. 声明 total_score 为全局变量
    global total_score
    # 3. 执行修改
    total_score += points

print(f"调用前分数: {total_score}")
# 4. 调用函数并验证
increase_score(25)
print(f"调用后分数: {total_score}")

二、为什么必须声明：Python 作用域与 UnboundLocalError 机制

很多初学者会产生疑问：在函数内部单纯使用 print(total_score) 时并不需要声明 global，为什么一旦执行 total_score = total_score + 1 就会直接抛出错误？

这是因为 Python 解析变量作用域的机制遵循 LEGB 规则（Local 局部 → Enclosing 闭包外层 → Global 全局 → Built-in 内建），且具备以下特性：

• 只读访问时：如果在局部作用域中找不到该变量，Python 会沿着作用域链自动向上查找全局变量，因此只读操作完全不需要额外的关键字。
• 存在赋值语句时：Python 在编译函数字节码时采用静态检查。只要函数内部任何位置出现了对某个变量的赋值（例如 =、+=、-=），Python 就会将该名字标记为当前函数的局部变量。

看下面的常见错误代码：

status_code = 200

def check_status():
    if status_code == 200:
        status_code = 500  # 这一行让解释器将 status_code 视为局部变量

check_status()

在上面这段代码中，虽然外部定义了 status_code，但因为函数体内有一句 status_code = 500，解释器便认定函数内部所有 status_code 都是局部变量。当执行到 if status_code == 200 时，局部变量还没被赋值，于是立刻触发了“赋值前引用局部变量”的异常。加入 global status_code 之后，便能消除这一歧义。

三、进阶使用技巧与易混淆边界

1. 同时声明多个全局变量

如果函数内需要修改多个全局变量，可以用逗号将变量名隔开，写在同一个 global 语句后，也可以分多行书写：

x = 10
y = 20

def modify_coordinates(new_x, new_y):
    global x, y  # 一次性声明多个全局变量
    x = new_x
    y = new_y

modify_coordinates(100, 200)
print(f"x: {x}, y: {y}")

2. 嵌套函数中的 global 与 nonlocal

在闭包或嵌套函数结构中，需要严格区分 global 与 nonlocal：

• global：不论嵌套多少层，始终直接绑定到最外层的模块级全局作用域。
• nonlocal：只绑定到外层闭包函数的局部作用域，不触及全局变量。外层函数必须已存在该变量，否则报语法错误。

3. 可变对象（列表、字典）原地修改无需 global

需要特别注意：global 是用来解决变量名重新绑定（Rebinding）问题的。如果全局变量是列表（list）或字典（dict）等可变对象，只是调用其内部方法修改内容（如 append() 或修改字典键值），并不需要声明 global：

config_data = {"theme": "light"}
user_list = []

def update_container():
    # 原地修改字典内容或追加列表元素，无需 global
    config_data["theme"] = "dark"
    user_list.append("Alice")

update_container()
print(config_data)  # 输出: {'theme': 'dark'}
print(user_list)    # 输出: ['Alice']

只有当你试图将全新的列表或字典重新赋值给该变量（如 config_data = {}）时，才需要使用 global config_data。

四、工程实践思考与替代设计方案

尽管 global 关键字在快速编写单脚本、设置全局调试标志位或统计简单计数时非常便捷，但在中大型项目中过多使用全局变量会带来显著隐患：

• 隐式依赖：函数可以在任何地方修改全局状态，使得函数的行为不再纯粹，难以追踪是哪个调用引发了状态改变。
• 并发安全风险：在多线程环境中，多个线程同时借助 global 修改同一全局变量极易产生竞态条件（Race Condition）。
• 测试隔离困难：测试用例之间会因为残留的全局状态相互干扰，降低单元测试的可靠性。

优雅替代方案：使用返回值重构

将状态作为参数传入，并在函数处理后返回新的状态，由调用者显式进行赋值更新。这种纯函数设计可以让代码的数据流动一目了然：

# 推荐的无副作用写法：参数传递与返回值
def add_points(current_total, points):
    return current_total + points

score = 100
# 由调用方显式更新外部变量，逻辑更透明
score = add_points(score, 50)
print(f"更新后分数: {score}")

优雅替代方案：使用类封装状态

当多个函数都需要读写一组关联的状态时，使用类进行面向对象封装是 Pythonic 的经典实践：

class CounterManager:
    def __init__(self, initial=0):
        self.count = initial

    def increment(self, step=1):
        self.count += step

# 实例化管理器，状态被封装在对象内部，天然隔离
app_counter = CounterManager(0)
app_counter.increment(5)
print(f"当前计数: {app_counter.count}")

五、核心要点总结速查

总结来说，当你在函数内部需要修改顶层全局变量时，直接在函数体开头加入 global 变量名 即可解决问题；而在长期维护的项目中，更推荐优先通过参数与返回值或类对象来组织代码，减少对全局状态的依赖。