Python函数中声明global仍无法修改全局变量问题排查

问题重现 #

定义全局变量keepPos后，在函数createBuilding3x3中使用global关键字声明并修改该变量，函数内打印显示变量已更新，但外部打印仍为初始值("N/A","N/A")。核心代码如下：

keepPos = ("N/A","N/A")

def createBuilding3x3(mPos,coinCounterLocal,mouseSquareX,mouseSquareY,selectedBuilding,keepPlaced):
    global keepPos
    if keepPlaced != True:
        gridSquareEmpty = True
        # 检查网格是否为空的逻辑
        for x in range (-1,2):
            for y in range (-1,2):
                if SSA[mouseSquareX+x][mouseSquareY+y] != 2:
                    gridSquareEmpty = False
                for i in buildingGroup:
                    if (mouseSquareX+x,mouseSquareY+y) == (i.getTileX(),i.getTileY()):
                        gridSquareEmpty = False
        if gridSquareEmpty == True:
            # 创建建筑的逻辑
            for x in range (-1,2):
                for y in range (-1,2):
                    if (x,y) != (0,0):
                        invisibleBuilding = Building(mouseSquareX+x,mouseSquareY+y,invisibleImage,0)
                        buildingGroup.add(invisibleBuilding)
            newBuilding = Building(mouseSquareX,mouseSquareY,imageList[selectedBuilding],0)
            buildingGroup.add(newBuilding)
            # 修改全局变量
            keepPos = (mouseSquareX,mouseSquareY)
            print(keepPos)  # 此处打印显示已修改为目标坐标
            print("The amount of active buildings is",len(buildingGroup))
            return True
    if keepPlaced == True:
        return True
    return False

# 函数调用后打印全局变量
print(keepPos)  # 此处仍显示初始值 ("N/A","N/A")

可能的原因及排查步骤 #

1. 函数未执行到修改变量的分支
   即使看到函数内有打印，也要确认每次调用createBuilding3x3时，keepPlaced传入的是False，且gridSquareEmpty最终计算为True。可以在函数开头和关键分支添加打印，追踪参数和变量状态：

   def createBuilding3x3(...):
       global keepPos
       print(f"函数调用，keepPlaced={keepPlaced}")
       if keepPlaced != True:
           # ...网格检查逻辑...
           print(f"网格检查结果：gridSquareEmpty={gridSquareEmpty}")
           if gridSquareEmpty == True:
               # ...修改keepPos的逻辑...
   

2. 全局变量被后续代码重新覆盖
   检查函数调用到外部打印keepPos之间的所有代码，看是否有其他地方重新给keepPos赋值为("N/A","N/A")，或者在其他函数中未使用global关键字就修改了同名变量（会创建局部变量，不会影响全局变量）。

3. 函数被多次调用，最后一次未触发修改
   如果程序中多次调用createBuilding3x3，第一次调用触发了keepPos修改，但后续调用时keepPlaced传入True（或gridSquareEmpty为False），此时函数直接返回True，不会修改全局变量。外部打印的是最后一次调用后的结果，因此显示初始值。

4. 模块导入导致的作用域问题
   如果这段代码属于某个模块，主程序中用from your_module import *导入变量时，会创建局部的keepPos副本。此时函数修改的是模块中的全局变量，但你打印的是主程序里的副本，两者互不影响。这种情况建议直接通过模块名访问变量（如your_module.keepPos）。

临时替代方案 #

如果暂时无法定位问题，可以将keepPos改为可变类型（如列表），无需global关键字也能修改其内部值，避免作用域问题：

# 改为列表
keepPos = ["N/A", "N/A"]

def createBuilding3x3(...):
    # 无需global关键字
    if gridSquareEmpty == True:
        # ...创建建筑逻辑...
        keepPos[0] = mouseSquareX
        keepPos[1] = mouseSquareY
        print(tuple(keepPos))

内容的提问来源于stack exchange，提问作者Toz H.