Python xmltodict库怎么用 XML与字典轻松互转

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 键下（如果同时有子标签和文本，会自动用该键区分）。

例如：

Alice

解析后是：{'person': {'@id': '123', '#text': 'Alice'}}

如想改前缀，可传参：parse(xml, attr_prefix='_') → 得到 '_id'；设 strip_whitespace=False 可保留文本首尾空格。

JoyPix AI

轻松制作AI视频、AI数字人，支持文生视频、声音克隆

243

查看详情

应对重复标签与列表结构

当同级出现多个相同标签（如多个 <item></item>），xmltodict 默认把它们合并成 list；但如果只有一个，就返回单个 dict —— 这可能导致代码判断类型不稳定。

解决方法：统一用 force_list 参数强制某些标签总是生成 list：

• parse(xml, force_list=('item', 'entry'))：无论 <item></item> 出现几次，结果里 ['item'] 都是列表
• 也支持正则：force_list=[re.compile(r'^item$')]

字典转 XML 的实用细节

unparse() 要求输入结构符合约定：顶层必须是单个 key（对应根元素），属性用 @key 表示，文本用 #text，子元素就是普通 key-value。

例如想生成：

Test

对应字典应为：

{'root': {'@version': '2.0', 'name': 'Test'}}

注意：unparse() 不校验结构合法性，若字典格式错（如根不是 dict、用了非法键名），会抛 ValueError 或生成无效 XML。