unboundlocalerror由编译期作用域判定触发：函数内任何赋值（含+=）使变量被标记为局部，若先读取后赋值则报错；global声明须在首行且不可在分支中；复合赋值如+=本质是重绑定，需global。
因为Python在函数编译阶段就锁定了变量作用域：只要函数体内对某个名字有赋值（包括 =、+=、-= 等），它就被标记为局部变量——哪怕这行赋值出现在读取操作之后。
UnboundLocalError 是怎么触发的
典型错误模式是：先 print(x)，再 x += 1。Python 编译时已把 x 判定为局部变量，执行到 print(x) 时，就去局部作用域找 x，但此时还没赋值，直接抛出 UnboundLocalError: local variable 'x' referenced before assignment。
- 这不是运行时逻辑判断失误，而是编译期静态分析决定的
-
x += 1等价于x = x + 1，本质仍是赋值语句 - 即使全局
x已存在，只要函数里有赋值，局部作用域就“遮蔽”了它
global 声明必须放在所有读写操作之前
global 不是“开关”，而是告诉解释器：“从函数开头起，这个变量名全程绑定到全局对象”。所以它必须出现在任何 print(x)、x += 1 之前，且不能出现在条件分支或循环内部。
- ✅ 正确：
global x在函数第一行，之后才print(x)和x += 1 - ❌ 报错：
print(x)在global x前 →SyntaxError: name 'x' is used prior to global declaration - ⚠️ 合法但多余：只读不写却加
global x—— 不报错，但无意义，还可能误导后续维护者
可变对象内容修改不需要 global
是否需要 global，关键看等号左边是不是纯变量名。如果是 data.append(1)、config['timeout'] = 30、cache.clear()，只是修改对象内部状态，变量名本身没变，就不需要 global。
- ✅ 无需
global：my_list.append(42)、settings.update({'debug': True}) - ❌ 必须
global：my_list = [1, 2, 3]、settings = {'debug': False}—— 这是重绑定，指向新对象 - ⚠️ 复合赋值陷阱：
my_list += [4, 5]看似是“追加”，实际等价于my_list = my_list + [4, 5]，会触发重绑定，需global
嵌套函数里混用 global 和 nonlocal 很危险
如果外层函数定义了 x，全局也定义了 x，而内层函数同时写了 global x 和 nonlocal x，行为未定义。Python 不允许一个名字在同一作用域链中被两种方式绑定。
- 想改全局？只用
global x，别碰外层同名变量 - 想改外层函数变量？只用
nonlocal x，确保外层真有该变量 - 两者都出现 → 可能静默失败或抛
SyntaxError，具体取决于 Python 版本和上下文
最常被忽略的是复合赋值的语义：它看起来像就地操作，实则是重绑定。哪怕你面对的是列表，+= 也可能触发全局变量报错，除非提前声明 global。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
