什么是 NameError？
在 Python 编程中，NameError 是一种常见的运行时异常，表示你试图使用一个未定义（或尚未定义）的变量名。
它通常发生在以下情况：
- 拼写错误导致变量名不匹配
- 在变量定义之前就尝试使用它
- 作用域问题：在函数内部引用了外部未声明的变量
- 忘记导入模块或函数
常见错误示例
示例 1：变量未定义
print(username)
# NameError: name 'username' is not defined变量 username 从未被赋值或定义。
示例 2：拼写错误
user_name = "Alice"
print(user_nam) # 少了一个 'e'
# NameError: name 'user_nam' is not defined示例 3：作用域问题
def greet():
name = "Bob"
greet()
print(name) # NameError: name 'name' is not defined变量 name 只在函数内部有效，外部无法访问。
如何解决 NameError？
- 检查拼写：确保变量名完全一致，注意大小写。
- 确认定义顺序：变量必须在使用前定义。
- 理解作用域：局部变量不能在函数外直接使用；如需共享，可使用
global或返回值。 - 正确导入模块：例如，使用
math.sqrt()前需先import math。 - 使用 IDE 或 Linter：现代编辑器（如 VS Code、PyCharm）能高亮未定义变量。
调试技巧
当遇到 NameError 时，可以：
- 查看完整的错误信息，定位出错行号
- 在该行附近检查所有变量是否已正确定义
- 使用
dir()或locals()查看当前作用域中的变量
# 调试小技巧
print(locals()) # 查看当前局部变量
print(globals()) # 查看全局变量总结
NameError 虽然基础，但频繁出现在初学者甚至有经验的开发者代码中。
养成良好的命名习惯、合理组织代码结构、善用开发工具，能大幅减少此类错误。
理解 Python 的变量作用域规则是避免 NameError 的关键。