为什么Python中局部变量与全局变量同名会报UnboundLocalError-Python教程-PHP中文网

Python在编译期即根据赋值语句标记变量为局部变量，导致未赋值前读取触发UnboundLocalError；global/nonlocal需提前声明作用域意图，而非事后补救；类方法中同名变量需用globals()或显式类名访问。

为什么python中局部变量与全局变量同名会报unboundlocalerror

Python编译期就锁定变量作用域，不是运行时才判断

报错根本原因不在“有没有定义”，而在Python解释器看到函数里有=（或+=、-=等赋值操作）时，**立刻把该变量标记为局部变量**。之后只要在赋值前读它，哪怕只有一行print(x)，就会触发UnboundLocalError: local variable 'x' referenced before assignment。

这个判定发生在函数被定义时（即编译阶段），和if条件是否为True、try块是否执行、甚至赋值语句是否真的运行过，完全无关。

if False: x = 1 → 整个函数里x仍被当作局部变量
try: ... except: x = 1 → 同样，x被锁死为局部
哪怕赋值语句在return之后，也改变不了编译期的判定

global和nonlocal不是“修复”，而是提前声明意图

加global x或nonlocal x不是在出错后补救，而是在函数开头就告诉Python：“我要操作的x不属于当前作用域”。不写，就默认按LEGB规则找；写了，就跳过局部查找，直接去指定作用域读写。

外层是模块级变量（即通常说的“全局变量”）→ 必须用global x
外层是嵌套函数里的变量（非全局）→ 必须用nonlocal x，用global会创建/修改全局变量，不是你想要的
nonlocal必须能向上找到对应变量名，否则报SyntaxError，不能“越层跳”
即使写了nonlocal x，外层函数也必须已定义x，否则运行时报NameError

类方法里同名变量更危险：global无效，globals()才管用

在类的方法中，如果模块顶层和类里都有同名变量（比如都叫count），写count = 10会定义局部变量；想读模块级count却先写了赋值，就必然报UnboundLocalError。这时global count只能绑定模块顶层的count，对类变量MyClass.count完全无效。

Python Pep Authoring

依据官方 python/peps仓库规则起草、审阅、编辑或准备 Python 改进提案（PEP），用于处理 PEP 文本和元数据头部。

下载

改类变量：用MyClass.count = 42或self.__class__.count = 42
读/写模块级同名变量：必须用globals()['count']，它绕过作用域链，直取模块字典
别依赖“没赋值就不会当局部变量”——只要语法上存在赋值，就已锁定

最常踩的坑：分支逻辑里变量未全覆盖赋值

这类错误看起来像逻辑缺陷，实则是作用域误判。例如：

def get_status(code):
    if code == 200:
        msg = "OK"
    elif code == 404:
        msg = "Not Found"
    return msg  # UnboundLocalError if code is 500

因为msg在某些路径下没被赋值，Python仍把它视为局部变量，但return msg在所有路径都执行，于是出错。