Python中GridSquare作为字典键删除前消失引发KeyError问题求助

首先，你遇到的所有问题都源于用自定义对象作为字典键时的核心规则：字典键的哈希值必须保持稳定，且对象的相等性判断要符合业务逻辑。

为什么直接修改键属性会报错 #

字典基于哈希表实现，当你修改GridSquare对象中影响哈希值的属性时，对象的哈希值会改变，导致字典无法正确定位这个键。循环过程中修改键会破坏哈希表的内部结构，Python为避免哈希表混乱，直接触发了运行时错误。

为什么删除旧键会出现KeyError #

大概率是以下几个原因：

• GridSquare未正确实现__eq__和__hash__方法：Python默认的哈希和相等性判断基于对象内存地址。如果没重写这两个方法，修改属性（比如index）后，旧GridSquare的哈希值可能改变，或者逻辑上相同的对象被判定为不同，导致字典找不到对应键。
• 重复收集了同一个旧对象：如果old_gridsquares列表里有重复的GridSquare实例，第一次删除后，第二次再删同一个键就会触发KeyError。
• 其他代码提前删除了键：关卡生成的其他逻辑可能已经修改了grid字典，删掉了你要处理的键，导致执行删除操作时键已不存在。

针对性解决方案 #

1. 让GridSquare成为合格的字典键 #

自定义对象要当字典键，必须保证哈希值不可变，且相等性判断符合业务逻辑。对于网格方块来说，index坐标是唯一身份标识，应基于它实现__eq__和__hash__，并且把index设为不可变类型（比如tuple）：

class GridSquare:
    def __init__(self, index, land):
        # index用tuple存储，保证不可变
        self.index = tuple(index)
        self.land = land

    def __eq__(self, other):
        # 两个GridSquare相等当且仅当index相同
        if not isinstance(other, GridSquare):
            return False
        return self.index == other.index

    def __hash__(self):
        # 哈希值基于index计算，保证稳定
        return hash(self.index)

这样只要index不变，哪怕修改land属性，对象的哈希值和相等性都不会变，你可以直接修改对象属性，不需要替换字典的键——这是最合理的做法，因为网格坐标本身不会改变，变化的只是网格属性。

2. 彻底避免用对象当键的麻烦 #

如果不想纠结哈希和相等性问题，直接用index元组作为字典的键，值存储GridSquare对象或对应游戏对象：

# 定义grid字典，键是index元组，值是GridSquare对象
grid = {(0,0): GridSquare((0,0), "grass"), (0,1): GridSquare((0,1), "water")}

# 修改网格属性时，直接通过index找到对象修改
grid[(0,0)].land = "rock"

这种方式更直观，完全规避了自定义对象当键的各种坑，非常适合游戏网格场景。

3. 修正现有流程（若必须用对象当键） #

如果坚持要用GridSquare当键，需注意：

• 永远不要修改影响哈希值的属性（比如index），仅修改land这类不影响哈希的属性，直接修改对象即可，无需替换键。
• 若确实需要替换键（游戏场景中很少见），确保old_gridsquares里的每个对象唯一，且删除前检查键是否存在：

for old_square in old_gridsquares:
    if old_square in grid:
        del grid[old_square]
# 再添加新对象
for new_square, game_objects in grid_changes:
    grid[new_square] = game_objects

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