必须用global声明才能修改模块级全局变量,否则赋值会创建同名局部变量;nonlocal用于嵌套函数修改外层局部变量;可变对象原地修改无需global,重绑定才需要;global不保证线程安全。

改全局变量必须用 global,否则赋值只是创建局部变量
在函数里直接给一个模块级变量赋值,Python 默认当成定义新局部变量——哪怕同名。这不是“改不了”,是根本没碰全局那个。错误现象很典型:UnboundLocalError: local variable 'x' referenced before assignment,或者改完发现模块外的值压根没变。
实操建议:
- 只要想在函数内**写入(=、+=、-= 等)**一个已存在的全局变量,开头第一句就得写
global x -
global声明后,对该变量的读和写都指向全局作用域,不声明只读是允许的(比如print(x)没问题) - 多个变量用逗号分隔:
global count, config, _cache - 注意:
global不能用于类属性或实例变量,它只管模块级(顶层)变量
nonlocal 只解决嵌套函数里的“上一级局部变量”,和全局无关
nonlocal 的存在不是为了替代 global,而是专治“闭包中间层变量被修改”的场景。比如外层函数定义了 def outer(): x = 10; def inner(): ...,这时 inner 想改 x,用 global 会去模块顶层找,错;不用声明直接赋值,又变成 inner 自己的局部变量。
实操建议:
-
nonlocal必须在嵌套函数中使用,且目标变量必须存在于**外层但非全局**的作用域中 - 找不到对应外层变量时,报
SyntaxError: no binding for nonlocal 'x' found - 不能用
nonlocal声明全局变量,也不能声明未定义的变量(不像global允许声明后首次赋值) - 常见于装饰器、工厂函数、状态保持型闭包中,比如计数器、缓存开关
误用 global 改字典/列表内容不需要声明
很多人卡在“为什么没写 global 却改成功了?”。关键在操作类型:对可变对象(dict、list、set)调用原地方法(.append()、.update()、del lst[0]),只是修改对象内容,没改变变量绑定关系,所以不需要 global。
实操建议:
- 以下操作无需
global:my_list.append(1)、config_dict['timeout'] = 30、data.clear() - 以下操作必须
global:my_list = [1, 2, 3](重绑定)、config_dict = {'new': True}(换对象) - 混淆点常出现在
+=:对 list 是原地扩展(不用 global),对 int 是重新赋值(要 global)——因为实现不同
多线程下改全局变量,global 不管线程安全
global 关键字只影响作用域解析,完全不涉及并发控制。多个线程同时执行 global counter; counter += 1,大概率出错,因为 += 不是原子操作(读-改-写三步)。
实操建议:
- 需要线程安全的全局状态,必须配合
threading.Lock或queue.Queue等同步机制 - 避免在多线程中依赖裸全局变量做状态协调,容易漏锁、死锁或逻辑错乱
- 如果只是读多写少,考虑用
threading.local()做线程私有副本,比争抢全局更稳妥
真正容易被忽略的是:作用域链查找和变量绑定是两个动作。Python 在编译函数时就决定了某个名字是局部、自由还是全局变量,运行时不会动态切换。写错 global 或漏写,往往不是语法错,而是语义错——你以为在改 A,其实新建了 B。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











