NameError通常因变量未定义、拼写错误、作用域问题或条件分支遗漏导致，需确保变量使用前已正确定义并检查命名一致性。
在使用Python编程时，遇到NameError: name 'xxx' is not defined是常见问题。这表示你尝试使用一个尚未被定义的变量或函数名。下面介绍几种典型场景和对应的解决方法。
1. 变量未声明就使用
这是最常见的原因。在使用变量前必须先赋值定义。
错误示例：print(username)
此时会提示：NameError: name 'username' is not defined，因为username从未被创建。
立即学习“Python免费学习笔记（深入）”；
解决方法：
在使用前先定义变量：
username = "Alice"
print(username)
2. 拼写错误或大小写不一致
Python对大小写敏感，name和Name是两个不同的变量。
user_name = "Bob"
print(userNmae) # 拼写错误
解决方法：
仔细检查变量名拼写，保持一致性：
user_name = "Bob"
print(user_name)
3. 变量作用域问题
在函数内部使用的变量如果没有在局部定义，且外部也未定义，就会报错。
错误示例：def my_func():
print(local_var)
my_func()
解决方法：
确保变量在正确的作用域内定义：
local_var = "I exist"
def my_func():
print(local_var)
my_func()
或者在函数内定义为局部变量，或使用global关键字声明全局变量。
4. 条件语句中未覆盖所有情况
有时变量只在某个条件分支中定义，但在其他分支未定义，后续代码却尝试使用。
错误示例：if False:
result = "Success"
print(result) # NameError
解决方法：
初始化变量以确保它始终存在：
result = None
if True:
result = "Success"
print(result)
基本上就这些。NameError多数源于粗心或逻辑遗漏，只要保证变量在使用前已正确定义，并注意拼写和作用域，就能有效避免。调试时可打印locals()或globals()查看当前命名空间中的变量。不复杂但容易忽略。
