NameError通常因变量未定义、拼写错误、作用域问题或条件分支遗漏导致，需确保变量使用前已正确定义并检查命名一致性。

在使用Python编程时，遇到NameError: name 'xxx' is not defined是常见问题。这表示你尝试使用一个尚未被定义的变量或函数名。下面介绍几种典型场景和对应的解决方法。

1. 变量未声明就使用

这是最常见的原因。在使用变量前必须先赋值定义。

print(username)

此时会提示：NameError: name 'username' is not defined，因为username从未被创建。

解决方法：

在使用前先定义变量：

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()查看当前命名空间中的变量。不复杂但容易忽略。