最推荐用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 <h1>创建根元素</h1><p>root = ET.Element("books")</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记(深入)</a>”;</p> <div class="aritcle_card"> <a class="aritcle_card_img" href="/ai/1623"> <img src="https://img.php.cn/upload/ai_manual/000/000/000/175680269964189.jpg" alt="因赛AIGC"> </a> <div class="aritcle_card_info"> <a href="/ai/1623">因赛AIGC</a> <p>因赛AIGC解决营销全链路应用场景</p> <div class=""> <img src="/static/images/card_xiazai.png" alt="因赛AIGC"> <span>280</span> </div> </div> <a href="/ai/1623" class="aritcle_card_btn"> <span>查看详情</span> <img src="/static/images/cardxiayige-3.png" alt="因赛AIGC"> </a> </div> <h1>添加子元素</h1><p>book = ET.SubElement(root, "book", id="1") title = ET.SubElement(book, "title") title.text = "Python 编程入门" author = ET.SubElement(book, "author") author.text = "张三"</p><h1>写入文件(带声明、UTF-8 编码、缩进需手动处理或用第三方库)</h1><p>tree = ET.ElementTree(root) tree.write("books.xml", encoding="utf-8", xml_declaration=True)</p>
让生成的 XML 更美观:添加缩进(Python 3.9+ 原生支持)
默认 write() 不带缩进。Python 3.9 起可直接用 ET.indent() 自动美化结构。
- 在
tree.write()前调用ET.indent(tree, space=" ") - 低版本 Python 可用 xmltodict 或手动递归加空格,但推荐升级或用更简洁的替代方案
简单键值对?用字典 + xmltodict(更易读)
如果原始数据是字典,且结构不深,xmltodict 配合 json 思路更直观。
示例:
import xmltodict <p>data = { "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)</p>
注意几个常见坑
- 中文写入失败?务必指定
encoding="utf-8"并在open()或write()中统一编码 - 特殊字符如
&、会被自动转义(<code>&、),这是正常行为,无需手动处理 - 不要用字符串拼接生成 XML —— 易出错、不安全、无法处理转义和嵌套
- 若需复杂命名空间(namespace),
ElementTree支持但语法稍繁琐,建议查阅官方文档中register_namespace()用法
不复杂但容易忽略