0

0

使用 collections.ChainMap 实现深度字典合并

霞舞

霞舞

发布时间:2025-08-11 19:10:19

|

379人浏览过

|

来源于php中文网

原创

使用 collections.chainmap 实现深度字典合并

本文探讨了如何利用 Python 的 collections.ChainMap 实现深度字典合并。标准 ChainMap 仅提供浅层合并,即遇到重复键时只取第一个值。针对嵌套字典场景,我们通过自定义 DeepChainMap 类并重写其 __getitem__ 方法,使其能够递归地合并相同键下的字典值,从而实现复杂的深度合并逻辑,有效处理多层嵌套的数据结构。

理解 collections.ChainMap 及其局限性

collections.ChainMap 是 Python collections 模块提供的一个类,它将多个字典或映射组合成一个单一的可更新视图。它维护一个映射列表,并在查找键时按照列表的顺序从左到右进行搜索,返回第一个找到的值。这对于需要按优先级合并配置或查找变量的场景非常有用。

考虑以下两个字典 a 和 b:

a = {'123': {'player': 1, 'opponent': 2},
     '18': {'player': 10, 'opponent': 12}}

b = {'123': {'winner': 1},
     '180': {'winner': 2}}

如果使用标准的 ChainMap 进行合并:

from collections import ChainMap

merged_map = ChainMap(a, b)
print(dict(merged_map))

输出结果为:

{'123': {'player': 1, 'opponent': 2}, '180': {'winner': 2}, '18': {'player': 10, 'opponent': 12}}

可以看到,对于键 '123',ChainMap 仅仅返回了字典 a 中对应的值 {'player': 1, 'opponent': 2},而忽略了字典 b 中 '123' 键下的 {'winner': 1}。这是因为 ChainMap 实现了浅层合并,它在遇到重复键时,只会返回映射列表中第一个找到的键值对,不会进一步合并键对应的值(如果它们也是字典)。

然而,我们期望的输出是:

{'123': {'player': 1, 'opponent': 2, 'winner': 1},
 '18': {'player': 10, 'opponent': 12},
 '180': {'winner': 2}}

这要求当多个字典中存在相同的键,并且这些键对应的值本身也是字典时,我们需要将这些嵌套的字典进行递归合并,而非简单地取第一个。

实现自定义 DeepChainMap 进行深度合并

为了实现这种深度合并行为,我们需要创建一个 ChainMap 的子类,并重写其 __getitem__ 方法。__getitem__ 是 Python 对象在通过 obj[key] 访问元素时调用的特殊方法。通过自定义此方法,我们可以在键查找时引入递归合并逻辑。

白月生产企业订单管理系统GBK2.0  Build 080807
白月生产企业订单管理系统GBK2.0 Build 080807

请注意以下说明:1、本程序允许任何人免费使用。2、本程序采用PHP+MYSQL架构编写。并且经过ZEND加密,所以运行环境需要有ZEND引擎支持。3、需要售后服务的,请与本作者联系,联系方式见下方。4、本程序还可以与您的网站想整合,可以实现用户在线服务功能,可以让客户管理自己的信息,可以查询自己的订单状况。以及返点信息等相关客户利益的信息。这个功能可提高客户的向心度。安装方法:1、解压本系统,放在

下载

以下是 DeepChainMap 的实现:

from collections import ChainMap

class DeepChainMap(ChainMap):
    """
    ChainMap 的变体,支持对嵌套字典进行递归深度合并。
    """
    def __getitem__(self, key):
        """
        重写 __getitem__ 方法,实现深度合并逻辑。
        当查找到的第一个值是字典时,递归地将所有映射中
        该键对应的字典值合并为一个新的 DeepChainMap。
        """
        # 收集所有映射中与给定键关联的值
        # 注意:这里会收集所有找到的值,即使它们不是字典
        values = (mapping[key] for mapping in self.maps if key in mapping)

        try:
            # 获取第一个找到的值
            first = next(values)
        except StopIteration:
            # 如果在任何映射中都未找到该键,则抛出 KeyError
            return self.__missing__(key)

        # 如果第一个找到的值是字典类型,则进行递归合并
        if isinstance(first, dict):
            # 使用当前 DeepChainMap 类,将第一个字典和后续找到的所有字典
            # 作为新的映射列表,递归创建并返回一个新的 DeepChainMap 实例。
            # 这样就实现了对嵌套字典的深度合并。
            return self.__class__(first, *values)

        # 如果第一个找到的值不是字典,则直接返回该值(标准 ChainMap 行为)
        return first

    def __repr__(self):
        """
        重写 __repr__ 方法,使其在打印时更清晰,直接显示为字典形式。
        """
        return repr(dict(self))

代码解析:

  1. __getitem__(self, key) 方法:
    • values = (mapping[key] for mapping in self.maps if key in mapping): 这一行是关键。它不是简单地返回第一个找到的值,而是创建一个生成器表达式,迭代 self.maps(即 ChainMap 内部维护的字典列表),收集所有映射中与 key 关联的值。
    • first = next(values): 尝试从 values 生成器中获取第一个值。
    • except StopIteration: return self.__missing__(key): 如果 values 为空(即 key 在所有映射中都不存在),则调用 __missing__ 方法(通常会抛出 KeyError),保持与标准字典和 ChainMap 一致的错误行为。
    • if isinstance(first, dict): return self.__class__(first, *values): 这是实现深度合并的核心逻辑。如果 first 值是一个字典,这意味着我们需要进一步合并它。我们通过 self.__class__(first, *values) 递归地创建了一个新的 DeepChainMap 实例。这个新的 DeepChainMap 的映射列表由 first 字典和 values 生成器中剩余的所有字典组成。当访问这个新的 DeepChainMap 内部的键时,会再次触发 __getitem__ 方法,从而实现多层嵌套字典的深度合并。
    • return first: 如果 first 值不是字典(例如,是字符串、整数、列表等),则直接返回它,保持 ChainMap 的默认行为。
  2. __repr__(self) 方法:
    • return repr(dict(self)): 这个方法是为了让 DeepChainMap 实例在被 print() 或在交互式环境中显示时,能够以更直观的字典形式展现,方便调试和理解。

示例用法

现在,我们可以使用 DeepChainMap 来实现我们期望的深度合并:

# 示例字典数据
a = {'123': {'player': 1,
             'opponent': 2},
     '18': {'player': 10,
            'opponent': 12}
    }

b = {'123': {'winner': 1},
     '180': {'winner': 2}
    }

# 使用自定义的 DeepChainMap 进行合并
deep_merged_map = DeepChainMap(a, b)

# 打印合并后的结果
print(deep_merged_map)

输出结果:

{'123': {'winner': 1, 'player': 1, 'opponent': 2}, '180': {'winner': 2}, '18': {'player': 10, 'opponent': 12}}

可以看到,对于键 '123',a 和 b 中对应的嵌套字典 {'player': 1, 'opponent': 2} 和 {'winner': 1} 已经被成功地合并成 {'winner': 1, 'player': 1, 'opponent': 2}。同时,其他不冲突的键 '18' 和 '180' 也被正确地包含在最终结果中。

注意事项与总结

  1. 合并顺序与优先级: DeepChainMap 继承了 ChainMap 的特性,其合并顺序仍然是从左到右。这意味着在深度合并嵌套字典时,如果多个字典中存在相同的内层键,靠前的字典中的值会优先被保留或合并。在上述示例中,{'winner': 1} 来自 b,{'player': 1, 'opponent': 2} 来自 a。最终 'winner' 键在 'player' 和 'opponent' 之后出现,这是因为在 DeepChainMap(a, b) 中,a 字典中的 '123' 被作为第一个映射传递给内层递归的 DeepChainMap。
  2. 非字典值的处理: 本文提供的 DeepChainMap 实现只针对值为字典的情况进行深度合并。如果相同键对应的值不是字典(例如,都是整数、字符串或列表),它将遵循 ChainMap 的默认行为,即返回第一个找到的值。如果需要对其他类型(如列表)进行特殊的深度合并(例如,列表拼接),则需要进一步扩展 __getitem__ 中的逻辑。
  3. 写入操作: 本文的 DeepChainMap 主要侧重于读取(__getitem__)时的深度合并行为。ChainMap 默认的 __setitem__ 和 __delitem__ 操作只作用于其映射列表中的第一个可写字典。如果需要对深度合并后的结构进行写入或删除操作,并希望这些操作能够影响到原始的嵌套字典,则需要额外重写 __setitem__ 和 __delitem__ 方法,并实现相应的递归写入/删除逻辑。
  4. 性能考量: 每次 __getitem__ 访问嵌套字典时都可能创建新的 DeepChainMap 实例,这在非常深层或频繁访问的场景下可能会有轻微的性能开销。但在大多数常规应用中,这种开销通常可以接受。

通过自定义 ChainMap 的 __getitem__ 方法,我们成功地将一个只支持浅层合并的工具扩展为能够处理复杂嵌套字典的深度合并器。这展示了 Python 灵活的面向对象特性和特殊方法(dunder methods)在构建自定义数据结构时的强大能力。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

751

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

636

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

758

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1262

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

706

2023.08.11

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 3.1万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号