UnboundLocalError 的根源在于编译期将函数内任何赋值的变量标记为局部，导致此前读取时在局部作用域找不到该变量；修复需定位并调整赋值语句或显式声明 global。

不会触发 UnboundLocalError —— 局部变量本来就不需要“声明”，但只要在函数内出现赋值语句（哪怕只在 if False: 里），Python 就会在编译期把它标记为局部变量；之后若在赋值前读取它，才报 UnboundLocalError。错误不在“赋值”，而在“先读、后赋”且该变量被判定为局部。

为什么 print(x) 在 x = 1 前就报错？

Python 编译函数时扫描全部代码，只要发现 x = ... 或 x += ... 这类赋值，就立即把 x 标记为局部变量。后续所有对 x 的读取（包括 print(x)）都只查局部作用域——而此时它还没被赋值，所以崩。

• x += 1 等价于 x = x + 1：先读 x（失败），再算，再赋
• 即使 x = 1 被包在 if False: 里，编译器仍会标记 x 为局部
• 错误提示位置是 print(x) 行，但根因永远在后面某处的赋值语句

用 global 声明却还报错？检查这三处

global 不是运行时补救，而是编译期指令。写得不对，等于没写。

提示词大师-python版

图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍

下载

• global x 必须出现在函数**最开头可执行位置**，不能藏在 if、try 或循环里
• 模块顶层必须已定义 x（否则首次 print(x) 会报 NameError）
• 不能和 from config import x 混用：导入的是名字绑定，global x 创建的是新全局名，不指向原变量

条件分支中变量未覆盖所有路径怎么办？

常见于 if/elif 只在部分分支赋值，导致某些执行流下变量未初始化。

立即学习“Python免费学习笔记（深入）”；

• 最稳妥：统一在函数开头初始化，比如 filename = None
• 或改用 match-case（Python 3.10+）确保穷尽性，但依然要保证每条分支都赋值
• 避免依赖“逻辑上应该走某分支”——Python 不做运行时路径分析，只看编译期是否所有可能路径都写入了变量

真正容易被忽略的是：这个错误从不发生在赋值那一刻，而总在读取时爆发；但修复点永远不在报错行，而在函数里某个看似无关的 = 或 += 上。