Python字典转XML无内置函数,可用xml.etree.ElementTree手动递归构建(推荐,无依赖)或dicttoxml库一键转换;需注意嵌套结构映射、特殊值处理、标签命名规范及UTF-8编码声明。

Python 字典转 XML 没有内置函数,但可以用标准库 xml.etree.ElementTree 手动构建,或借助第三方库如 dicttoxml 快速实现。关键在于理解字典嵌套结构如何映射为 XML 标签层级,以及如何处理特殊值(如 None、list、int)。
用 ElementTree 手动构建 XML(推荐,无依赖)
适合对 XML 结构有明确要求、需精细控制标签名、属性和顺序的场景。核心思路是递归遍历字典,逐层创建 Element 对象。
- 根节点单独创建,子节点用
subelement()添加 - 字典键 → XML 标签名;值为字符串/数字 → 标签文本;值为字典 → 递归生成子节点;值为列表 → 为每个元素创建同名子节点
- 注意转义:字符串内容会自动转义(如
→zuojiankuohaophpcn),无需手动处理
示例代码:
import xml.etree.ElementTree as ETdef dict_to_xml(tag, d): elem = ET.Element(tag) for key, val in d.items(): if isinstance(val, dict): child = dict_to_xml(key, val) elem.append(child) elif isinstance(val, list): for item in val: child = dict_to_xml(key, item) elem.append(child) else: child = ET.Element(key) child.text = str(val) elem.append(child) return elem
示例字典
data = { "book": { "title": "Python入门", "author": "张三", "price": 59.9, "tags": ["编程", "Python"] } }
root = dict_to_xml("root", data) tree = ET.ElementTree(root) tree.write("output.xml", encoding="utf-8", xml_declaration=True)
用 dicttoxml 库一键转换(简单快捷)
安装:pip install dicttoxml。适合快速原型、结构较规则的字典,省去手动递归逻辑。
立即学习“Python免费学习笔记(深入)”;
- 默认将字典键转为标签名,值转为文本;列表自动加包裹标签(可禁用)
- 支持自定义根节点名、忽略空值、添加属性(如
id)、输出字符串或文件 - 不支持复杂嵌套命名空间,纯内容导出足够用
示例:
from dicttoxml import dicttoxml from xml.dom.minidom import parseStringdata = {"name": "Alice", "age": 30, "hobbies": ["reading", "coding"]} xml_bytes = dicttoxml(data, custom_root="person", attr_type=False) dom = parseString(xml_bytes) print(dom.toprettyxml(indent=" "))
处理常见问题:None、数字、布尔值和中文
ElementTree 默认把 None 转成字符串 "None",需提前过滤或替换;数字和布尔值会自动转为字符串(True → "True"),如需保持原格式,可统一转为字符串再写入 text 属性。
- 中文完全支持,只要保存时指定
encoding="utf-8"并加xml_declaration=True - 避免键含空格或特殊字符:XML 标签名不能以数字开头、不能含空格,建议预处理键名(如转下划线)
- 若需属性而非子节点(如
),创建元素后用elem.set("id", "101")
保存为文件并验证格式
用 tree.write() 保存后,可用浏览器或 VS Code 插件打开 XML 文件查看是否格式良好。若报错“not well-formed”,常见原因是:
基本上就这些。手动用 ElementTree 更可控,用 dicttoxml 更省事——按需选就行。










