Python双人答题游戏UnboundLocalError报错排查及修复求助

错误核心原因 #

这个报错本质是Python找不到player2points的有效定义，常见两种情况：

• 变量是全局定义的，但你在函数内修改它时没加global声明，Python会把它当作局部变量处理，导致引用时找不到赋值；
• 变量是函数内的局部变量，但你在赋值前就直接引用（比如先执行player2points += 100，却没先给它初始值0）；
• 分支逻辑有漏洞，比如只在if分支里给变量赋值，else分支直接引用，导致某些代码路径下变量未初始化。

针对性修复方案 #

1. 全局变量场景（最常见） #

如果player2points是在所有函数外定义的全局积分变量，在函数内修改它必须先声明global：

# 全局初始化玩家积分
player1points = 0
player2points = 0

def check_player2_answer(correct_ans, user_ans):
    global player2points  # 声明要使用全局的player2points变量
    if user_ans == correct_ans:
        player2points += 100
        print("玩家2答对！加100分")

2. 局部变量场景 #

如果变量只在函数内使用，一定要先初始化再操作：

def run_full_game():
    # 先初始化局部积分变量
    player2points = 0
    for _ in range(20):
        # 出题、获取玩家答案的逻辑
        correct_answer = "Beijing"
        user_input = input("玩家2：中国首都是？")
        if user_input == correct_answer:
            player2points += 100
    # 输出最终结果
    print(f"玩家2最终积分：{player2points}")

3. 补全分支逻辑 #

确保所有代码路径里变量都有初始值，避免分支遗漏：

# 错误写法：else分支直接引用变量，但可能未赋值
def calculate_round_score():
    if is_correct:
        player2points = 100
    print(player2points)  # 当is_correct为False时，变量未定义

# 正确写法：先初始化，再根据分支修改
def calculate_round_score():
    player2points = 0
    if is_correct:
        player2points += 100
    print(player2points)

快速排查步骤 #

1. 定位代码中player2points第一次出现的位置，判断是全局变量还是局部变量；
2. 若为全局变量，检查函数内修改时是否加了global声明；
3. 若为局部变量，确认有没有在使用（比如+=、print）前完成初始化（比如player2points = 0）；
4. 检查所有if/elif/else分支，确保每个路径下变量都有值。

内容的提问来源于stack exchange，提问作者Mahavir Soppannavar