Python字典元素莫名变更原因排查：重复键的覆盖问题

兄弟，我太能理解你碰到这个问题时的懵圈了——明明代码里没碰过那些值，每次运行字典前几个元素的索引1值都变，单独拎出来跑也一样，甚至把值从'2'改成'two'，输出居然还是'2'，这简直邪门了对吧？

问题复现 #

你创建的checklist字典里，大量键都被重复声明了，比如"pine logs"先定义为['logs', '2', '4']，后面又重新定义成['logs', '3', '4']：

checklist = { 
"pine logs": ['logs', '2', '4'], 
"travertine": ['rocks', '2', '4'], 
"iron ore": ['ores', '2', '4'], 
"medium hide": ['hides', '2', '4'], 
"hemp": ['fibers', '2', '4'], 
"pine logs": ['logs', '3', '4'],  # 这里覆盖了前面的"pine logs"
"travertine": ['rocks', '3', '4'],  # 覆盖前面的"travertine"
# ... 后续还有大量重复键的声明
} 
print(checklist)

运行后输出的字典里，每个键只保留了最后一次赋值的结果，比如"pine logs"的值变成了['logs', '3', '4']，这就是你看到“值莫名变更”的核心原因。

问题根源 #

Python字典有个容易踩坑的特性：重复声明相同的键不会抛出任何错误，只会用后面的键值对直接覆盖掉前面的。这是字典的核心规则——每个键必须是唯一的，当你重复定义同一个键时，Python会默认你是要更新这个键对应的值，而非保留多个值。

你之前改值为'two'但输出还是'2'，大概率是改了前面的键值对，后面重复声明的键又把值改回了'2'，所以最后输出的始终是后面的赋值结果。

解决建议 #

如果你的需求是同一个键对应多个值，不能直接重复声明键，得换个数据结构：

• 方案1：把每个键的值改成列表的列表，手动存储多组数据：

  checklist = { 
  "pine logs": [['logs', '2', '4'], ['logs', '3', '4']], 
  "travertine": [['rocks', '2', '4'], ['rocks', '3', '4']],
  # ... 其他键同理调整
  }
  

• 方案2：用collections.defaultdict自动处理多值场景，更灵活：

  from collections import defaultdict
  
  checklist = defaultdict(list)
  checklist["pine logs"].append(['logs', '2', '4'])
  checklist["pine logs"].append(['logs', '3', '4'])
  checklist["travertine"].append(['rocks', '2', '4'])
  checklist["travertine"].append(['rocks', '3', '4'])
  # ... 其他键依次append对应数据
  

这样就能保留同一个键对应的所有值了。

内容的提问来源于stack exchange，提问作者The Cubic Log