unboundlocalerror仅在函数内触发，因编译期将赋值左侧变量标记为局部变量，导致后续读取时找不到；解决关键是提前初始化变量，而非依赖global/nonlocal。
UnboundLocalError只在函数定义体里触发，因为作用域判定发生在编译期
这个错误根本不会在模块顶层、交互式命令行或类定义体外出现——它专属于函数内部。原因在于：Python在编译函数时就扫描全部代码，只要看到变量名出现在=、+=、-=等赋值操作的左侧，立刻把它标记为局部变量。后续所有对该变量的读取，都默认去局部命名空间找，哪怕实际执行路径根本没走到赋值那行。
常见错误现象：
-
UnboundLocalError报错位置往往在print(x)这种读取语句，但根源藏在后面某个x = ...或x += ... -
if False: x = 1这种永远不会执行的赋值，照样让整个函数里的x变成局部变量 - 函数里只读不写全局变量（比如
print(count)），完全没问题；一旦出现count += 1，立刻触发错误
global和nonlocal不是“修复工具”，而是编译前必须声明的意图
很多人以为加个global就能“救活”已报错的变量，其实不是。这两个关键字的作用是告诉编译器：“别把下面出现的x当成局部变量，它属于外层作用域”。声明必须出现在函数顶部，不能塞在if分支里，否则语法错误。
使用场景与坑点：
- 想改模块级变量 → 必须用
global x，且模块顶层得真有x = ...定义，否则首次print(x)会报NameError - 嵌套函数里想改外层函数的变量 → 只能用
nonlocal x，global会创建同名全局变量，不是你想要的 -
nonlocal只能绑定到直接外层函数，跨两层要链式写：nonlocal x在中间层，再在外层函数里也写nonlocal x - 类方法里对
self.x误用nonlocal→ 直接SyntaxError，实例属性和闭包变量是两回事
最稳妥的解法：别依赖global/nonlocal，从变量初始化入手
多数真实项目里，global和nonlocal反而增加理解成本和维护风险。更直接的做法是确保变量在任何读取前都有确定值。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
实操建议：
- 所有可能被读取的变量，在函数开头统一初始化：
result = None、labels = [] - 条件分支中变量赋值不完整？补默认分支或提前初始化：
bbb2 = None再进if/elif - 循环里定义变量但循环可能不执行？把初始化提到循环外：
i = 0，再for i in range(...) - 用
dict.get(key, default)、getattr(obj, 'attr', default)替代可能未定义的访问
容易被忽略的细节：复合赋值和可变对象的差异
+=这种操作既是读又是写，对不可变类型（int、str）会触发UnboundLocalError，但对可变类型（list、dict）行为不同。
关键区别：
-
my_list.append(1)不触发错误——没对my_list本身赋值，只是调用方法 -
my_list += [1]触发错误——等价于my_list = my_list + [1]，涉及重新赋值 -
my_dict['key'] = value不触发错误——没对my_dict变量赋值，只修改其内容
真正危险的是那些看起来像“修改”、实则暗含“重新绑定”的操作。盯住=符号左侧出现的变量名，比记住规则更可靠。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
