xmltodict是纯Python轻量库,可双向转换XML与嵌套字典:parse()将XML转为OrderedDict,unparse()将字典转为格式化XML;支持属性前缀、文本标记、重复标签强制列表及编码设置。

xmltodict 是一个轻量级 Python 库,能把 XML 字符串直接转成嵌套字典(dict),也能把字典反向生成格式良好的 XML。它不依赖外部 C 库,纯 Python 实现,安装简单,适合快速解析配置、API 响应或简单数据交换场景。
安装与基础用法
用 pip 安装:
pip install xmltodict
最常用的是两个函数:parse()(XML → dict)和 unparse()(dict → XML)。
立即学习“Python免费学习笔记(深入)”;
-
xmltodict.parse(xml_string):输入字符串,返回 OrderedDict(保留标签顺序),可传encoding指定编码,attr_prefix自定义属性前缀(默认@) -
xmltodict.unparse(dict_obj, pretty=True):输入字典,输出 XML 字符串;pretty=True会自动缩进换行,便于阅读
处理 XML 属性和文本内容
xmltodict 默认把 XML 属性存为键名带 @ 前缀的字段,文本内容存在 #text 键下(如果同时有子标签和文本,会自动用该键区分)。
例如:
解析后是:{'person': {'@id': '123', '#text': 'Alice'}}
如想改前缀,可传参:parse(xml, attr_prefix='_') → 得到 '_id';设 strip_whitespace=False 可保留文本首尾空格。
应对重复标签与列表结构
当同级出现多个相同标签(如多个 ),xmltodict 默认把它们合并成 list;但如果只有一个,就返回单个 dict —— 这可能导致代码判断类型不稳定。
解决方法:统一用 force_list 参数强制某些标签总是生成 list:
-
parse(xml, force_list=('item', 'entry')):无论出现几次,结果里['item']都是列表 - 也支持正则:
force_list=[re.compile(r'^item$')]
字典转 XML 的实用细节
unparse() 要求输入结构符合约定:顶层必须是单个 key(对应根元素),属性用 @key 表示,文本用 #text,子元素就是普通 key-value。
例如想生成:
对应字典应为:
{'root': {'@version': '2.0', 'name': 'Test'}}
注意:unparse() 不校验结构合法性,若字典格式错(如根不是 dict、用了非法键名),会抛 ValueError 或生成无效 XML。










