如何检测Python字典初始化时的键覆盖问题

Python的字典字面量会自动忽略重复键，只保留最后一个值，要检测这种情况或保留第一个值，需要绕过默认的字典初始化逻辑，以下是几种可行方案：

1. 自定义构建函数 #

通过遍历键值对逐个添加，遇到重复键时抛出异常或保留第一个值：

def build_unique_dict(key_value_pairs):
    result = {}
    for key, val in key_value_pairs:
        if key in result:
            # 可选：抛出异常提示重复
            raise ValueError(f"检测到重复键: {key}")
            # 或者保留第一个值，跳过后续重复项
            # continue
        result[key] = val
    return result

# 使用示例
my_dict = build_unique_dict([('one', 1), ('two', 2), ('three', 3), ('three', 6)])

2. 自定义字典类 #

继承dict并重写__setitem__方法，确保每次添加键时都检查是否已存在：

class UniqueDict(dict):
    def __setitem__(self, key, value):
        if key in self:
            raise ValueError(f"键 {key} 已存在，当前值为 {self[key]}")
            # 保留第一个值则直接返回，不更新
            # return
        super().__setitem__(key, value)
    
    def __init__(self, key_value_pairs=None, **kwargs):
        super().__init__()
        if key_value_pairs:
            for k, v in key_value_pairs:
                self[k] = v
        # 注意：**kwargs会被Python预处理重复键，建议优先使用key_value_pairs参数
        if kwargs:
            for k, v in kwargs.items():
                self[k] = v

# 使用示例
my_dict = UniqueDict([('one', 1), ('two', 2), ('three', 3), ('three', 6)])

3. 处理JSON加载场景 #

如果是从JSON数据加载字典，可利用json.loads的object_pairs_hook参数检测重复键：

import json

def check_unique_json_pairs(pairs):
    result = {}
    for key, val in pairs:
        if key in result:
            raise ValueError(f"JSON中存在重复键: {key}")
            # 保留第一个值则跳过
            # continue
        result[key] = val
    return result

# 示例JSON字符串
json_data = '{"one":1, "two":2, "three":3, "three":6}'
my_dict = json.loads(json_data, object_pairs_hook=check_unique_json_pairs)

关键说明 #

直接使用字典字面量（如{'one':1, 'three':3, 'three':6}）无法检测重复键，因为Python在编译阶段就会自动去重并保留最后一个值，必须通过迭代键值对的方式逐个添加，才能在过程中检查重复。

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