Python XML生成案例如何创建XML内容

wen python案例 2026-06-30 24

Python XML生成案例：从零开始创建XML内容的完整指南

目录导读

为什么需要掌握Python生成XML？
Python生成XML的三种主流方法对比
ElementTree库实战：生成简单XML
lxml库进阶：带命名空间的复杂XML
DOM方式生成：适合超大文档的场景
常见错误与性能优化技巧
问答专区：高频问题深度解答
选择最适合你的方案

为什么需要掌握Python生成XML？

XML（可扩展标记语言）至今仍是数据交换、配置文件、API响应格式的核心载体，无论是处理Sitemap、RSS Feed、SOAP消息，还是与遗留系统对接，Python开发人员都绕不开XML生成任务，根据Stack Overflow 2024年开发者调查，25%的后端开发者每月至少处理一次XML相关操作。

Python XML生成案例如何创建XML内容

真实场景案例：

电子商务平台需要每小时生成商品数据XML推送给Google Shopping
气象系统将传感器数据转换为XML格式存档
医疗系统HL7消息的生成与解析

掌握Python生成XML不仅是技术需求，更是提升开发效率的关键，下面我们将通过完整案例，手把手教你用三种主流库生成结构正确、可扩展的XML内容。

Python生成XML的三种主流方法对比

库名称	适用场景	性能	学习曲线
xml.etree.ElementTree	中小规模文档、初学者首选	中等	低
lxml	需要XPath/XSLT、命名空间支持	高	中
xml.dom.minidom	兼容旧代码、熟悉DOM开发者	低	高

笔者建议：90%的日常场景选择ElementTree即可；当需要XSD校验、高性能解析或复杂命名空间时果断使用lxml。

ElementTree库实战：生成简单XML

1 基础结构创建

import xml.etree.ElementTree as ET
# 创建根元素
root = ET.Element("bookstore")
# 添加子元素
book = ET.SubElement(root, "book")
book.set("id", "bk101")
= ET.SubElement(book, "title")text = "Python编程从入门到实践"
author = ET.SubElement(book, "author")
author.text = "埃里克·马瑟斯"
price = ET.SubElement(book, "price", currency="CNY")
price.text = "89.00"
# 生成字符串
tree = ET.ElementTree(root)
tree.write("books.xml", encoding="utf-8", xml_declaration=True)

2 生成缩进美观的XML

默认输出没有换行缩进,使用以下代码美化：

import xml.dom.minidom as minidom
def pretty_xml(root):
    rough_string = ET.tostring(root, encoding='unicode')
    dom = minidom.parseString(rough_string)
    return dom.toprettyxml(indent="  ")
print(pretty_xml(root))

输出效果：

<?xml version="1.0" ?>
<bookstore>
  <book id="bk101">Python编程从入门到实践</title>
    <author>埃里克·马瑟斯</author>
    <price currency="CNY">89.00</price>
  </book>
</bookstore>

3 批量生成商品列表（真实案例）

def generate_products(product_list):
    root = ET.Element("products")
    for pid, pdata in product_list.items():
        prod = ET.SubElement(root, "product", id=pid)
        name = ET.SubElement(prod, "name")
        name.text = pdata["name"]
        category = ET.SubElement(prod, "category")
        category.text = pdata["cat"]
        # 嵌套子元素示例
        dimensions = ET.SubElement(prod, "dimensions")
        width = ET.SubElement(dimensions, "width")
        width.text = pdata["w"]
        height = ET.SubElement(dimensions, "height")
        height.text = pdata["h"]
    return ET.ElementTree(root)
# 使用
products = {
    "P001": {"name": "机械键盘", "cat": "外设", "w": "44", "h": "12"}
}
tree = generate_products(products)
tree.write("catalog.xml", encoding="utf-8", xml_declaration=True)

lxml库进阶：带命名空间的复杂XML

当需要生成SOAP消息或XML Schema时,命名空间必不可少。

from lxml import etree
# 定义命名空间映射
nsmap = {
    None: "http://example.com/ns/default",
    "xsi": "http://www.w3.org/2001/XMLSchema-instance",
    "soap": "http://schemas.xmlsoap.org/soap/envelope/"
}
# 使用QName创建带命名空间的元素
root = etree.Element("{http://example.com/ns/default}response", nsmap=nsmap)
item = etree.SubElement(root, "{http://example.com/ns/default}item")
item.set("{http://www.w3.org/2001/XMLSchema-instance}type", "book")
item.text = "Effective Python"
# 输出
result = etree.tostring(root, pretty_print=True, encoding='unicode')
print(result)

输出XML片段：

<response xmlns="http://example.com/ns/default" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <item xsi:type="book">Effective Python</item>
</response>

性能优势：lxml比ElementTree快3-5倍,适合生成超过10万行的大型XML。

DOM方式生成：适合超大文档的场景

虽然DOM方式占用内存高,但需要频繁修改中间节点时更灵活。

from xml.dom.minidom import Document
doc = Document()
root = doc.createElement("library")
doc.appendChild(root)
book = doc.createElement("book")
book.setAttribute("isbn", "978-7-121-34378-3")
= doc.createElement("title")text = doc.createTextNode("流畅的Python")appendChild(title_text)
book.appendChild(title)
# 添加注释
comment = doc.createComment(" 畅销编程书 ")
root.appendChild(comment)
root.appendChild(book)
# 输出
print(doc.toprettyxml(indent="  "))

注意：DOM方式内存消耗随文档大小线性增长,建议仅在XML小于50MB时使用。

常见错误与性能优化技巧

1 五大常见错误

未设置xml_declaration：导致XML解析器无法识别编码
特殊字符未转义：<、&、> 需使用<、&等实体
属性值未加引号：虽然ET会自动处理，但手写字符串时要谨慎
重复根元素：一个XML文档只能有一个根节点
内存溢出：超大文档使用xml.sax.saxutils或逐行写入

2 性能优化三板斧

尽量减少toString()调用：使用write()方法直接写入文件
使用编译模式：etree.XMLParser(encoding="utf-8")预编译
增量生成：针对百万级记录使用xml.sax.saxutils.XMLGenerator流式写入

问答专区：高频问题深度解答

Q1：如何在XML中生成CDATA段？ A：ElementTree不直接支持CDATA，可用lxml的etree.CDATA()：

from lxml import etree
root = etree.Element("data")
script = etree.SubElement(root, "script")
script.text = etree.CDATA("if a < b then print('ok')")

Q2：生成XML时需要包含Schema吗？ A：建议在根元素添加xsi:schemaLocation属性,方便校验：

root.set("{http://www.w3.org/2001/XMLSchema-instance}schemaLocation", "http://example.com schema.xsd")

Q3：如何控制属性顺序？ A：Python 3.8+的字典有序特性可保证属性顺序，但规范的XML解析器不应该依赖顺序，如需强制排序，在lxml中使用sorted()按key排序属性。

Q4：生成XML时中文乱码怎么办？ A：确认三处编码一致：

tree.write("out.xml", encoding="utf-8")  # 必须UTF-8

另外检查文件开头是否有BOM（字节顺序标记）,部分老旧系统会遇到此问题。

Q5：能否直接生成符合XSD的XML？ A：lxml可配合xmlschema库在生成后校验，但更推荐先生成再校验的策略，实时校验会增加生成时间2-4倍。

选择最适合你的方案

场景	推荐方案	理由
生成Sitemap、RSS	ElementTree	简单高效，标准库内置
企业级SOAP接口	lxml	完美支持命名空间和XSD
教学Demo	DOM/ElementTree	代码可读性强
高性能数据导出	lxml增量写入	内存占用低，速度极快

最终建议：长期项目中建议统一使用lxml，它同时提供ElementTree兼容接口和高级功能,迁移成本几乎为零。

通过以上完整案例，你应该能轻松构建任何结构的XML文档，核心原则是“先规划结构，再编写代码”——在生成XML前用草稿画出树形结构图，可减少50%的调试时间。