Python在编译阶段将函数内任何赋值的变量标记为局部变量，导致未赋值前读取引发UnboundLocalError；需用global声明访问同名全局变量，或改用参数传递。
为什么在函数里给变量赋值会导致UnboundLocalError
当你在函数内部对一个变量名执行赋值操作（哪怕只在某一分支中），Python会在编译阶段将该变量标记为“局部变量”。此后，只要在赋值前尝试读取它（比如 print(x)），就会触发 UnboundLocalError: local variable 'x' referenced before assignment —— 即使同名的全局变量确实存在。
这不是运行时才判断的作用域问题，而是静态分析的结果。Python不支持“先读全局、后写局部”的混合行为。
- 错误典型场景：
if分支中只在某个条件下赋值，但其他路径试图读取 - 常见误判：以为
if False: x = 1不会影响作用域，其实仍会触发局部声明 - 注意：仅读取（无赋值）不会触发此错误，此时自动回退到全局/外层作用域查找
如何明确告诉Python“我要用全局变量”
在函数开头使用 global 声明，是唯一能安全读写同名全局变量的方式。它强制 Python 忽略局部变量推断逻辑，全程绑定到模块级变量。
但要注意：一旦用了 global，所有对该变量的读写都指向全局；不能再在同一函数中混用局部同名变量。
x = 10 <p>def f(): global x print(x) # ✅ 读全局 x = 20 # ✅ 写全局 </p>
- 必须在函数内首次使用该变量前声明，否则报
SyntaxError - 不能对嵌套作用域（nonlocal）变量用
global，那是nonlocal的职责 - 多个变量可一次声明：
global a, b, c
用函数参数或返回值替代全局读写更安全
绝大多数情况下，真正需要的是数据传递，而不是共享状态。把全局变量作为参数传入，再显式返回新值，逻辑更清晰、测试更容易、线程也更安全。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
尤其当变量只是临时计算中间态，或只被少数几个函数协作使用时，参数方式几乎总比 global 更合适。
- 避免副作用：函数不再隐式修改外部状态
- 兼容性更好：可直接用于多线程、异步协程等场景
- 示例：
def process(data, config=None): return data * 2比依赖全局CONFIG更易复用 - 若 config 确实需全局配置，建议封装成不可变对象（如
types.SimpleNamespace或dataclass(frozen=True)）
调试时怎么快速定位是哪个变量触发了UnboundLocalError
错误信息里的变量名就是线索，但容易忽略的是：它可能不是你一眼看到的赋值语句，而是隐藏在条件分支、循环体、甚至 try/except 中的赋值。
最有效的排查方式是反向扫描：从报错行向上找，看该变量是否在任何路径中被赋过值（包括 for x in ...、with ... as x、except Exception as x 这类隐式赋值）。
- 检查所有可能执行到的代码路径，哪怕它们被
if False包裹 - 留意
for循环变量、异常别名、上下文管理器别名——它们都是真实赋值 - 用
dis.dis(f)查看字节码，确认变量是否被标记为STORE_FAST（局部）而非STORE_GLOBAL
实际开发中，真正需要 global 的场景极少。多数未绑定错误，根源在于函数职责过重、状态管理混乱，而不是语法没用对。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
