在 Python 编程中，<code>NameError: name 'xxx' is not defined 是一个常见的错误。它表示在当前作用域中找不到名为 xxx 的变量或函数。这篇博客将详细介绍导致这一错误的常见原因，并提供相应的解决方法，帮助你更好地理解和解决这一问题。

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

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

【Python】成功解决python报错：NameError: name 'xxx' is not defined的解决方案

1. 什么是 NameError？2. 常见原因及解决方法2.1 变量未定义错误示例解决方法

2.2 变量名拼写错误错误示例解决方法

2.3 变量作用域问题错误示例解决方法

2.4 模块未导入或导入错误错误示例解决方法错误示例解决方法

2.5 函数未定义错误示例解决方法

2.6 类未定义错误示例解决方法

2.7 使用未导入的名称错误示例解决方法

2.8 动态生成的变量名错误示例解决方法

2.9 检查导入路径错误示例解决方法

3. 常见的调试方法3.1 打印变量3.2 使用 IDE 的调试工具3.3 查看堆栈跟踪

4. 预防 NameError 的最佳实践4.1 遵循命名规范4.2 模块化编程4.3 使用 linters 和静态分析工具4.4 单元测试

5. 结论6. 参考资料

1. 什么是 NameError？

<code>NameError 是 Python 中的一种内置异常，当尝试访问未定义的变量或函数时会引发这一异常。错误信息通常类似于：

NameError: name 'xxx' is not defined

这意味着 Python 解释器在当前作用域中找不到名为 xxx 的变量或函数。

2. 常见原因及解决方法

2.1 变量未定义

在使用变量之前，必须先定义它。

错误示例

print(x) # NameError: name 'x' is not defined

解决方法

定义变量 x 然后再使用它。

x = 10

print(x) # 输出: 10

2.2 变量名拼写错误

检查变量名的拼写是否正确，确保一致性。

错误示例

my_variable = 10

print(my_varible) # NameError: name 'my_varible' is not defined

解决方法

修正变量名的拼写错误。

my_variable = 10

print(my_variable) # 输出: 10

2.3 变量作用域问题

确保变量在当前作用域中可见。

错误示例

def my_function():

x = 10

my_function()

print(x) # NameError: name 'x' is not defined

解决方法

使用 global 关键字声明全局变量，或者将变量作为函数的返回值。

def my_function():

global x

x = 10

my_function()

print(x) # 输出: 10

或者：

def my_function():

x = 10

return x

x = my_function()

print(x) # 输出: 10

2.4 模块未导入或导入错误

在使用模块中的名称之前，必须先正确导入模块。

错误示例

print(math.pi) # NameError: name 'math' is not defined

解决方法

导入 math 模块。

import math

print(math.pi) # 输出: 3.141592653589793

确保模块名称和使用的名称一致。

错误示例

import math as m

print(math.pi) # NameError: name 'math' is not defined

解决方法

import math as m

print(m.pi) # 输出: 3.141592653589793

2.5 函数未定义

在调用函数之前，必须先定义它。

错误示例

my_function() # NameError: name 'my_function' is not defined

def my_function():

print("Hello, World!")

解决方法

确保在调用函数之前定义它。

def my_function():

print("Hello, World!")

my_function() # 输出: Hello, World!

2.6 类未定义

在实例化类之前，必须先定义它。

错误示例

obj = MyClass() # NameError: name 'MyClass' is not defined

class MyClass:

pass

解决方法

确保在实例化类之前定义它。

class MyClass:

pass

obj = MyClass()

2.7 使用未导入的名称

确保在使用库中的名称之前，已经正确导入库。

错误示例

from math import sqrt

print(math.sqrt(4)) # NameError: name 'math' is not defined

解决方法

确保导入正确的名称。

from math import sqrt

print(sqrt(4)) # 输出: 2.0

# 或

import math

print(math.sqrt(4)) # 输出: 2.0

2.8 动态生成的变量名

如果你动态生成变量名，确保在使用之前已经定义。

错误示例

for i in range(3):

exec(f"var{ i} = i * 10")

print(var0) # NameError: name 'var0' is not defined

解决方法

确保动态生成的变量名在当前作用域中可见。

for i in range(3):

exec(f"var{ i} = i * 10")

print(var0) # 输出: 0

print(var1) # 输出: 10

print(var2) # 输出: 20

2.9 检查导入路径

确保模块导入路径正确。

错误示例

from mymodule import my_function # 如果 mymodule 不在 sys.path 中，可能会报错

解决方法

确保模块路径在 sys.path 中。

import sys

sys.path.append('/path/to/your/module') # 替换为实际的路径

from mymodule import my_function

3. 常见的调试方法

3.1 打印变量

在代码中插入打印语句，检查变量是否正确定义和赋值。

x = 10

print(f"x is defined as: { x}")

3.2 使用 IDE 的调试工具

现代 IDE（如 PyCharm、VS Code）提供了强大的调试工具，可以设置断点、单步执行代码、查看变量值等。

3.3 查看堆栈跟踪

当 NameError 发生时，Python 会提供堆栈跟踪信息，帮助你找到错误发生的位置。仔细阅读堆栈跟踪信息，可以快速定位问题。

4. 预防 NameError 的最佳实践

4.1 遵循命名规范

遵循一致的命名规范，确保变量和函数名称清晰、易读。

4.2 模块化编程

将代码分解为多个模块和函数，避免在全局作用域中定义过多变量。

4.3 使用 linters 和静态分析工具

使用 linters（如 pylint）和静态分析工具（如 mypy）检查代码中的潜在问题。

4.4 单元测试

编写单元测试，确保每个函数和模块都能正常工作。测试框架（如 unittest、pytest）可以帮助你自动化测试过程。

5. 结论

NameError: name 'xxx' is not defined 是 Python 中常见的错误之一。通过了解其常见原因和解决方法，你可以更好地调试和解决这一问题。本文详细介绍了变量未定义、拼写错误、作用域问题、模块导入错误等常见情况，并提供了相应的解决方法和最佳实践。

希望这篇文章能帮助你更好地理解和解决 NameError 错误。如果你有任何问题或需要进一步的帮助，请随时留言讨论！

6. 参考资料

Python 官方文档 - 异常PyCharm Debugging GuidePylint 官方文档unittest 官方文档pytest 官方文档