NameError通常由未定义变量、拼写错误、作用域问题或未导入模块引起。1. 使用前需定义变量；2. 注意名称大小写和拼写；3. 局部变量不可在外部访问，可通过返回值传递；4. 调用函数前应导入相应模块，如from math import sqrt。
在使用 Python 编程时，NameError 是一个常见的异常类型，通常表示你尝试访问一个未定义的变量或函数名。它提示解释器无法在当前作用域中找到指定的名称。下面介绍几种引发 NameError 的典型场景及其解决方法。
1. 使用了未定义的变量
这是最常见的原因。当你试图引用一个从未被创建或赋值的变量时，Python 会抛出 NameError。
示例：print(username) # 报错：NameError: name 'username' is not defined
解决方法：确保变量在使用前已正确定义。
username = "Alice" print(username) # 正常输出 Alice
2. 变量名拼写错误
变量名大小写不一致或拼写错误也会导致 NameError。Python 是区分大小写的语言。
立即学习“Python免费学习笔记（深入）”；
示例：user_name = "Bob" print(username) # 报错：name 'username' is not defined（注意 user_name 和 username 不同）
解决方法：检查变量名是否拼写正确，包括大小写和下划线。
print(user_name) # 正确调用3. 变量作用域问题
在函数内部定义的变量默认是局部的，不能在函数外部访问。
示例：
def greet():
message = "Hello!"
greet()
print(message)
# 报错：name 'message' is not defined解决方法：将变量设为全局变量，或通过返回值传递。
def greet():
global message
message = "Hello!"
greet()
print(message) # 正常输出 Hello!或者更推荐的方式：
def greet():
return "Hello!"
message = greet()
print(message)4. 函数或模块未导入
调用了一个未导入的函数或模块中的名称。
示例：result = sqrt(25) # 报错：name 'sqrt' is not defined
解决方法：导入所需模块。
from math import sqrt result = sqrt(25) print(result)
或者使用完整模块路径：
import math result = math.sqrt(25)
基本上就这些常见情况。只要注意变量定义、命名一致性、作用域规则和模块导入，就能有效避免大多数 NameError。
