Python实现Key-Value配置文件比对与合并

Cora

发布时间：2026-10-13 | 5人浏览过

原创

本文介绍使用Python处理常见Key-Value格式配置文件比对与合并的方法。针对Linux diff工具在复杂配置场景下的局限性，提供自定义脚本实现新增配置项的自动提取与追加。代码演示如何解析配置文件、过滤注释行，并将新文件中的差异配置项安全地合并至旧文件，适用于版本发布时的配置同步场景。

配置文件类型与比对挑战

在实际工作场景中，配置文件主要呈现为四种常见形态：基础的Key-Value键值对格式、JSON结构化格式、HTML标记格式以及YAML格式。

其中，Key-Value格式的应用最为广泛，而其余三种格式多见于成熟的开源软件项目中。鉴于此，本文仅聚焦于第一种Key-Value格式的配置文件处理方案。

通常情况下，Linux Shell环境提供了diff命令用于普通文本配置文件的比对，Python标准库difflib也提供了字符串及HTML格式的比较接口。然而，在真实的项目实践中，这些通用工具往往难以直接使用，核心原因在于配置文件缺乏统一的标准规范，导致通用比对工具无法准确识别差异。

定制化比对工具实现

为解决上述痛点，最佳实践是针对特定项目定制专用的配置文件比对工具。这类工具在软件版本发布阶段具有极高的实用价值。接下来直接展示相关实现代码：

核心代码逻辑解析


#!/usr/bin/python
#coding=utf-8
'''
此脚本适用于比较key=value格式的配置文件
使用方式为：
config_match.py old_file new_file
最终会将new_file中的新增配置项添加入old_file中，old_file中已有的配置项不会做任何改变。
'''
import re
import os,sys
reload(sys)
sys.setdefaultencoding("utf-8")
try:
  old_file = sys.argv[1]
  new_file = sys.argv[2]
except Exception,e:
  print("Error:" +str(e))
  print("Usage: config_match.py old_file new_file")
  sys.exit()
def list2dict(file):
  with open(file,'r') as f:
    list=f.readlines()
  #遍历str list，排除空行和以#开头的str，使用split将str元素转为[k,v]元素
  for e in list[0:]:
    if re.match('^#',e) or re.match('^$',e):
      list.remove(e)
  i=0
  for e in list:
    e_split=e.strip().split('=')
    if len(e_split)==2:
      k,v=e.strip().split('=')
      list[i]=[k,v]
    else:
      pass
    i=i+1
  #至此list变为了[[k,v],[k,v],...]这样的list
  #包含多个=号或者不包含=号的配置项会被忽略,这点要注意
  return dict(list)
old_dict=list2dict(old_file)
new_dict=list2dict(new_file)
'''
遍历新配置文件,将新增配置项加入conf_need_added{}字典中，然后将conf_need_added{}字典以k=v格式append入旧文件中。
如果重复的键值也需要更新那就太简单了，dict类型自带的update()方法就可以很好的完成任务，根本无需这么折腾了。
'''
conf_need_added={}
for k,v in new_dict.items():
  if k not in old_dict.keys():
    conf_need_added[k]=v
  else:
    pass
with open(old_file,'a') as f:
  for k,v in conf_need_added.items():
    f.write('\n#以下为新增配置项:\n')
    f.write(str(k)+'='+str(v)+'\n')