unboundlocalerror 因函数内赋值使变量被编译期标记为局部，导致先读未赋值而报错；global 必须在任何读写前声明，仅重绑定变量名（如 x = ...）需 global，修改可变对象内容（如 x.append()）则无需。
UnboundLocalError 是怎么被触发的
函数内出现 UnboundLocalError: local variable 'x' referenced before assignment，根本原因不是“不能改全局变量”，而是 Python 在编译函数时就锁定了变量的作用域：只要函数体中对某个名字有赋值（包括 +=、-=、=），它就被标记为局部变量——哪怕这行赋值在 print(x) 后面。
典型错误模式：
- 先
print(x)（试图读全局） - 再
x += 1（触发局部变量声明） - 执行时，
print阶段去局部作用域找x，但还没赋值，直接报错
这不是运行时逻辑错误，是编译期决定的作用域规则。Python 不允许一个变量在同一作用域里“既局部又全局”。
global 声明必须出现在赋值之前
global 不是“让修改生效”的开关，而是告诉解释器：“这个变量名从头到尾都指向全局对象，别把它当局部变量处理”。所以它必须出现在任何对该变量的读/写操作之前，且通常放在函数顶部附近。
正确写法示例：
x = 100
def func():
global x # ✅ 必须在这儿，且在 print 或 += 之前
print(x) # 读取全局 x
x += 1 # 修改全局 x
func()
常见错误写法：
-
global x放在print(x)后面 → 报SyntaxError: name 'x' is used prior to global declaration - 函数里只读不写，却加了
global x→ 语法合法但多余，不推荐 - 嵌套函数中混用
global和nonlocal操作同一变量名 → 行为未定义，应避免
什么时候其实根本不需要 global
如果你只是修改可变对象的内容，而不是重新绑定变量名，global 完全不需要。因为变量名本身没变，只是它指向的对象内部状态变了。
例如：
-
data.append(1)、config['timeout'] = 30、cache.clear()—— 不需要global -
data = [1, 2, 3]、config = {'timeout': 30}、cache = {}—— 必须加global
关键判断点：看等号左边是不是只有变量名。如果是，就是重绑定；如果左边是带下标、属性或方法调用的表达式，通常只是就地修改。
复合赋值（+=, -= 等）本质仍是赋值
a += b 看似是“读+改+写”，但在 Python 中它被解析为单条赋值语句，和 a = a + b 等价。因此它同样会触发局部变量判定，也必须配合 global 使用。
容易忽略的陷阱：
-
count += 1和count = count + 1行为一致，都需要global count - 对不可变对象（如
int,str,tuple）做任何“修改”，本质上都是创建新对象并重绑定变量名，所以几乎总要global - 对可变对象调用
.sort()、.reverse()这类就地方法，不重绑定变量名，不用global
真正难缠的不是语法，而是习惯性把“改内容”和“改变量名”当成一回事。盯住等号左边那个裸名，就抓住了关键。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
