【Python】成功解决python报错：UnboundLocalError: local variable ‘xxx‘ referenced before assignment

成功解决python报错：UnboundLocalError: local variable ‘xxx’ referenced before assignment。在Python中，UnboundLocalError是一种特定的NameError，它会在尝试引用一个还未被赋值的局部变量时发生。Python解释器需要知道变量的类型和作用域，因此，在局部作用域内引用一个未被赋值的变量时，就会抛出这个错误。

---

🧑 博主简介：现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

问题背景

在Python编程中，UnboundLocalError: local variable 'xxx' referenced before assignment 是一个常见的错误，尤其是在写函数时可能会遇到。这篇技术博客将详细介绍UnboundLocalError，为什么会发生，以及如何解决这个错误。

1. 什么是UnboundLocalError？

在Python中，UnboundLocalError是一种特定的NameError，它会在尝试引用一个还未被赋值的局部变量时发生。Python解释器需要知道变量的类型和作用域，因此，在局部作用域内引用一个未被赋值的变量时，就会抛出这个错误。

2. 常见的场景和原因

这是一个简单的代码示例来说明这个错误：

def my_function():
    print(x)  # 尝试引用未定义的局部变量x
    x = 10

my_function()

运行以上代码会抛出以下错误：

UnboundLocalError: local variable 'x' referenced before assignment

在这个例子中，Python解释器看到print(x)时，寻找局部作用域中的变量x，但这个变量在局部作用域内尚未被赋值（虽然在后面有赋值，解释器是从上到下执行代码的）。

3. 解决办法

理解错误的原因后，可以通过以下几种方式来解决UnboundLocalError：

方法一：全局变量

如果变量希望在函数内和函数外都使用，可以将其声明为全局变量：

x = 10

def my_function():
    global x  # 声明x为全局变量
    print(x)

my_function()  # 输出: 10

通过在函数内使用global关键字，将x声明为全局变量，这样即使在函数内也能访问全局变量x。

方法二：函数参数

通过将变量作为参数传递给函数，使得函数内可以访问并使用这个变量：

def my_function(x):
    print(x)

x = 10
my_function(x)  # 输出: 10

在这种情况下，x是函数my_function的一个参数，无需在函数内部声明。

方法三：局部变量初始化

在使用变量之前，先初始化该局部变量：

def my_function():
    x = 10  # 先初始化
    print(x)

my_function()  # 输出: 10

确保在函数内部引用变量之前，该变量已经被赋值。

方法四：结合条件语句

在复杂的逻辑中，特别是在涉及条件语句时，可以先在函数开始部分初始化变量，确保无论哪条路径都可以正确访问该变量：

def my_function(condition):
    x = None  # 初始化变量
    if condition:
        x = 10
    print(x)

my_function(True)  # 输出: 10
my_function(False)  # 输出: None

在这个例子中，我们确保了变量x在函数内部任何地方都能被适当地引用。

4. 其他注意事项

• 命名冲突：在全局变量和局部变量重名情况下，优先使用局部变量。如果不小心混用，容易引发错误。
• 提前规划变量作用域：代码设计时，可以提前规划好变量应该属于哪个作用域，以减少变量冲突和未定义变量的情况。

结论

UnboundLocalError: local variable 'xxx' referenced before assignment 错误是一个常见的初学者错误，但只要理解了Python的变量作用域规则和执行顺序，就可以轻松避开。通过合适的解决方法，如使用全局变量、函数参数、局部变量初始化或结合条件语句，可以高效且清晰地管理变量的使用。

希望这篇文章能帮助你理解和解决这个错误。如果有任何问题或其他建议，欢迎在评论中与我们讨论。Happy coding!