Python代码输入b2触发UnboundLocalError报错求助

错误根源：Python变量作用域规则 #

这不是VS Code的问题，是Python核心语法规则导致的：函数内部如果存在对变量的赋值语句（无论是否会被执行），Python会将该变量标记为局部变量。当你在函数中引用这个变量时，Python会优先查找局部作用域，而非全局作用域。

以你的代码为例：

• 在calculate函数中，存在a2 = 'white'（move=="a2"分支）、a2 = 'none'（move=="a3"分支）这类赋值操作，因此a2被标记为局部变量。
• 当输入move为b2时，上述赋值a2的分支都不会执行，局部的a2从未被定义，但后续判断a2 == 'black'尝试引用这个未定义的局部变量，直接触发UnboundLocalError。

同理，b1、b2、c1等变量也存在相同的作用域问题，只是这次报错先出在a2上。

解决方案 #

方案1：使用global声明全局变量 #

在calculate函数开头添加global关键字，明确告诉Python这些变量是全局作用域的，而非局部变量：

def calculate(move):
    global a, b, c, last_move, a1, b1, c1, a2, b2, c2, a3, b3, c3
    
    if move == "a2": a1 = 'none'; a2 = 'white' 
    if move == "b2": b1 = 'none'; b2 = 'white'
    # 后续代码保持不变

方案2：封装状态到字典/类（推荐） #

全局变量容易引发副作用，更规范的做法是将所有游戏状态封装到字典或类中，通过传递对象来修改状态：

# 初始游戏状态字典
game_initial_state = {
    'a': True,
    'b': True,
    'c': True,
    'last_move': 'None',
    'a1': 'white',
    'b1': 'white',
    'c1': 'white',
    'a2': 'none',
    'b2': 'none',
    'c2': 'none',
    'a3': 'black',
    'b3': 'black',
    'c3': 'black'
}

def calculate(move, state):
    if move == "a2": 
        state['a1'] = 'none'
        state['a2'] = 'white'
    if move == "b2": 
        state['b1'] = 'none'
        state['b2'] = 'white'
    if move == "c2": 
        state['c1'] = 'none'
        state['c2'] = 'white'
    if move == "a3": 
        state['a2'] = 'none'
        state['a3'] = 'white'
    if move == "b3": 
        state['b2'] = 'none'
        state['b3'] = 'white'
    if move == 'c3': 
        state['c2'] = 'none'
        state['c3'] = 'white'

    if state['a2'] == 'black' and state['b1'] == 'white': 
        return "axb1"
    if state['b2'] == 'black' and state['a1'] == 'white': 
        return "bxa1"
    if state['b2'] == 'black' and state['c1'] == 'white': 
        return "bxc1"
    if state['c2'] == 'black' and state['b1'] == 'white': 
        return "cxb1"

    if state['a2'] == 'black' and state['a1'] == 'none': 
        return "a1"
    if state['b2'] == 'black' and state['b1'] == 'none' and state['b'] == True: 
        print("b1")
        return None
    if state['c2'] == 'black' and state['c1'] == 'none': 
        return "c1"
    
    if state['a3'] == 'black' and state['b2'] == 'white': 
        state['a1'] = 'none'
        state['a'] = False
        state['b'] = False
        state['b2'] = 'black'
        state['last_move'] = "axb2"
        return "axb2"
    if state['c3'] == 'black' and state['b2'] == 'white' and state['a'] == True: 
        state['c1'] = 'none'
        state['b2'] = 'black'
        state['last_move'] = "cxb2"
        return "cxb2"
    if state['b3'] == 'black' and state['a2'] == 'white': 
        state['b1'] = 'none'
        state['a2'] = 'black'
        state['last_move'] = "bxa2"
        return "bxa2"

def game_launch():
    print("launched new game.")
    # 复制初始状态，避免每次游戏互相影响
    current_state = game_initial_state.copy()
    s = input("type and send a move. ")
    print(calculate(s, current_state))
    s = input("type and send a move. ")
    print(calculate(s, current_state))

补充说明 #

你之前觉得代码“正常运行”是巧合——比如之前输入的move刚好触发了对相关变量的赋值，局部变量被定义，因此没有报错，但代码本身的作用域问题一直存在。

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