Python doctest字典相等性测试异常通过，是Python Bug吗？

你遇到的确实是Python 3.11.x版本中doctest的一个已知bug：

1. 字典匹配的异常逻辑
   在Python 3.11的部分小版本里，doctest对字典的字符串表示匹配存在漏洞：当预期的字典字符串是实际字典字符串的前缀子集（且键顺序一致）时，doctest会错误判定两者匹配。比如你遇到的场景：实际结果是{'a': 'a', 'b': 'b', 'c': 'c'}，预期是{'a': 'a', 'c': 'c'}，由于预期字符串和实际字符串的首尾部分重合，doctest误判为匹配；但当你在预期末尾添加逗号后，预期字符串变为{'a': 'a', 'c': 'c',}，此时和实际字符串的结构差异足够明显，doctest才会正确识别不匹配。

2. sorted字典项的匹配问题
   同理，测试sorted()后的字典项列表时，如果预期的列表字符串是实际列表字符串的子串，doctest也会出现类似的误判。而assert语句直接比对对象内容而非字符串，因此能正确触发失败。

解决办法 #

• 改用显式断言替代直接输出比对：这是最可靠的方案，跳过字符串匹配，直接验证字典内容：

  >>> result = drop_keys_conditionally({'a':'a', 'b':'b', 'c':'c'})
  >>> assert 'b' not in result
  >>> assert result == {'a':'a', 'c':'c'}
  

• 启用doctest严格匹配模式：在测试用例后添加# doctest: +STRICT注释，强制doctest进行完全精确的字符串匹配：

  >>> drop_keys_conditionally({'a':'a', 'b':'b', 'c':'c'})  # doctest: +STRICT
  {'a': 'a', 'c': 'c'}
  

• 升级Python版本：该bug在Python 3.12及后续版本中已被修复，升级到更高版本可直接解决此问题。

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