提问人： 提问时间：3/1/2014 最后编辑：Karl Knechtel 更新时间：5/26/2023 访问量：48874
如何在 Python 中“解绑”名称？什么代码会导致“UnboundLocalError”？
How can a name be "unbound" in Python? What code can cause an `UnboundLocalError`?
问：
我在 Python 文档中阅读了以下内容：
如果根本找不到名称，则会引发异常。如果当前作用域是函数作用域，并且名称引用的局部变量在使用该名称时尚未绑定到值，则会引发异常。 是 的子类。
。
Python 缺少声明，并允许在代码块中的任何位置进行名称绑定操作。NameErrorUnboundLocalErrorUnboundLocalErrorNameError
我不明白这是如何工作的。如果没有声明，那么什么时候会提出？遇到变量“not yet be bound”时，它怎么能绑定？UnboundLocalError
另请参阅 UnboundLocalError 尝试使用（重新）分配的变量（应该是全局变量）（即使在首次使用后）来解决一个常见问题，其中预期是全局变量，而是局部变量。这个问题的重点是程序员希望变量是局部变量的情况。
答：
24赞
Martijn Pieters
3/1/2014
#1
您可以在不分配名称的情况下引用名称：
>>> foobar
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
NameError: name 'foobar' is not defined
这里被提及，但从未被分配到。这会引发一个，因为该名称从未绑定过。foobarNameError
更微妙的是，这里没有发生赋值，因为执行的行永远不会运行：
>>> def foo():
... if False:
... spam = 'eggs'
... print(spam)
...
>>> foo()
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
File "<stdin>", line 4, in foo
UnboundLocalError: local variable 'spam' referenced before assignment
因为从未执行过，所以会引发 .spam = 'eggs'print(spam)UnboundLocalError
请注意，Python 中没有任何地方声明过名称。你绑定或不绑定，声明不是语言的一部分。
相反，绑定用于确定名称的作用域;绑定操作包括赋值、用于循环的名称、函数参数、import 语句、用于保存子句中捕获的异常的名称以及语句中上下文管理器的名称。forexceptwith
如果名称绑定在作用域（例如在函数中）中，则它是本地名称，除非您使用语句（或 Python 3 中的语句）将名称显式标记为全局（或闭包）。globalnonlocal
所以下面是一个错误：
>>> foo = None
>>> def bar():
... if False:
... foo = 'spam'
... print(foo)
...
>>> bar()
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
File "<stdin>", line 4, in bar
UnboundLocalError: local variable 'foo' referenced before assignment
因为被绑定在函数作用域中的某个位置。但是，如果您标记为全局，则该函数可以工作：foobarfoo
>>> foo = None
>>> def bar():
... global foo
... if False:
... foo = 'spam'
... print(foo)
...
>>> bar()
None
因为现在 Python 编译器知道你想成为一个全局。foo
这一切都记录在 Python 参考文档的命名和绑定部分。
评论
0赞
3/1/2014
很好的例子，谢谢！这是否意味着在开始执行该块的代码之前创建了指定的块绑定？
0赞
Martijn Pieters
3/1/2014
@Dmitrii：编译器将本地名称与代码块一起存储;这样，字节码就可以使用正确的操作码来加载全局名称、本地名称和闭包。
1赞
kindall
3/1/2014
Python 在编译为字节码时确定变量是否为本地变量。如果它曾经被分配给，它是本地的（除非有 or 声明）。globalnonlocal
4赞
kindall
3/1/2014
你在技术上是正确的......最好的正确。（不过，在我看来，所有这些都是任务。
2赞
Martijn Pieters
3/1/2014
@kindall：参考手册称其为绑定，然后将赋值命名为绑定的操作。在 SO 上写答案时，最好坚持使用官方术语。:-)
2赞
venpa
3/1/2014
#2
另一个地方是当变量在全局作用域中声明时，如果它在函数作用域中使用，它应该专门引用全局，否则会发生 UnboundLocalError。示例如下：
var = 123
def myfunc():
var = var + 1
print var
myfunc()
错误：
UnboundLocalError: local variable 'var' referenced before assignment
评论
0赞
Karl Knechtel
2/6/2023
我编辑了这个，但后来又回滚了，因为我认为我改变了它的精神太多了。相反，我将我想做出的改变整合到一个全新的答案中。
1赞
Karl Knechtel
2/6/2023
#3
UnboundLocalError是一种特殊的 ，专门指局部变量。在函数外部的代码中导致 s 的相同类型的逻辑问题，也可能导致函数内部的逻辑问题。NameErrorNameErrorUnboundLocalError
通常，在尝试编写没有任何回退的条件逻辑时，会出现此问题：
import random
def example_if():
if random.random() < 0.5:
result = 1
return result
print(example_if())
每当条件不满足时，这将失败，因为在这种情况下，没有分配给 的任何内容，因此无法使用它。这里需要了解的是，变量没有“默认值”值，并且分配给某些内容与使用 .您需要显式定义回退，例如：resultNonedel
def example_if():
result = 1 if random.random() < 0.5 else 0
return result
（此错误也可能是带有缩进的逻辑错误的症状：检查使用该变量的代码是否也应该在块内。if
一个偷偷摸摸的变体是一个循环，它应该分配值，但运行零次：
def example_for():
for i in range(0): # this loop will not be entered
result = 1 # therefore this assignment will not happen
return result
print(example_for()))
在更实际的示例中，循环可能无法运行，因为它正在循环访问未找到任何内容的搜索操作（例如另一个循环）的结果，或者因为它正在循环访问已读取的文件。for
UnboundLocalError尝试修改尚未分配的变量时也可能发生：
def example_increment():
result += 1
example_increment()
发生这种情况是因为需要先查找现有值，然后才能对其进行修改，但没有什么可查找的。
无论哪种方式，即使全局范围内有 a，也会发生错误，因为 Python 提前决定将变量视为局部变量。要解决此问题，除了提供初始全局值外，还可以使用 global 关键字。它必须在每个想要修改全局的函数中使用。（在全局范围内不起作用。resultglobal
import random
result = 1
def example_increment():
global result
result += 1
def example_if():
global result
if random.random() < 0.5:
result = 1
return result
example_increment() # result becomes 2
print(example_if()) # may or may not reset to 1
如果值是只读的，则不需要使用。但是，全局不能用于设置同名局部值的初始值：global
result = 1
def does_not_work():
result = result # trying to set a "default" value for a local
if random.random() < 0.5:
result = 2
return result
无论哪种方式，这都行不通。按原样，将发生。如果添加到函数中，则不会产生任何影响，并且该函数可能会修改全局（此处不需要）。对于这些情况，解决方法是简单地为本地使用不同的名称。UnboundLocalErrorglobal resultresult = result
评论