最推荐用xml.etree.ElementTree模块创建XML文件:先用ET.Element()建根节点,ET.SubElement()添加子节点并设.text和.set()属性,再用ET.ElementTree(root).write()保存,需指定encoding='utf-8'和xml_declaration=True;Python 3.9+可用ET.indent()自动缩进美化。

用Python创建XML文件最常用、最推荐的方法是使用内置的 xml.etree.ElementTree 模块。它轻量、标准、无需额外安装,适合大多数结构化数据导出场景。
用 ElementTree 构建并写入 XML 文件
这是最直观的方式:先构建元素树,再保存为文件。
- 用
ET.Element()创建根节点 - 用
ET.SubElement()添加子节点,支持嵌套 - 通过
.text设置文本内容,.set()添加属性 - 调用
ET.ElementTree(root).write()保存,注意设置encoding='utf-8'和xml_declaration=True保证格式规范
示例:
import xml.etree.ElementTree as ET创建根元素
root = ET.Element("books")
立即学习“Python免费学习笔记(深入)”;
添加子元素
book = ET.SubElement(root, "book", id="1") title = ET.SubElement(book, "title") title.text = "Python 编程入门" author = ET.SubElement(book, "author") author.text = "张三"
写入文件(带声明、UTF-8 编码、缩进需手动处理或用第三方库)
tree = ET.ElementTree(root) tree.write("books.xml", encoding="utf-8", xml_declaration=True)
让生成的 XML 更美观:添加缩进(Python 3.9+ 原生支持)
默认 write() 不带缩进。Python 3.9 起可直接用 ET.indent() 自动美化结构。
- 在
tree.write()前调用ET.indent(tree, space=" ") - 低版本 Python 可用 xmltodict 或手动递归加空格,但推荐升级或用更简洁的替代方案
简单键值对?用字典 + xmltodict(更易读)
如果原始数据是字典,且结构不深,xmltodict 配合 json 思路更直观。
- 先安装:
pip install xmltodict - 构造 Python 字典 → 转成 XML 字符串 → 写入文件
- 适合配置类、简单报表等场景,代码更贴近语义
示例:
import xmltodictdata = { "config": { "@version": "2.0", # @ 开头表示属性 "host": "localhost", "port": "8080", "debug": "true" } } xml_str = xmltodict.unparse(data, pretty=True) with open("config.xml", "w", encoding="utf-8") as f: f.write(xml_str)
注意几个常见坑
- 中文写入失败?务必指定
encoding="utf-8"并在open()或write()中统一编码 - 特殊字符如
&、会被自动转义(&、),这是正常行为,无需手动处理 - 不要用字符串拼接生成 XML —— 易出错、不安全、无法处理转义和嵌套
- 若需复杂命名空间(namespace),
ElementTree支持但语法稍繁琐,建议查阅官方文档中register_namespace()用法
不复杂但容易忽略










