Python xml.etree.ElementTree SubElement如何创建XML子节点

在Python的xml.etree.ElementTree模块中，SubElement是用于快速为已有XML元素创建子节点的工具函数，它比手动创建Element对象再添加到父节点的方式更简洁，能大幅减少冗余代码。

SubElement的基本语法

SubElement函数的定义如下，它需要接收父节点对象作为第一个参数，后续参数用于配置子节点的属性：

from xml.etree import ElementTree as ET

# SubElement函数签名
# ET.SubElement(parent, tag, attrib={}, **extra)

参数说明：

• parent：父节点Element对象，子节点会被自动添加到这个父节点的子节点列表中
• tag：子节点的标签名称，字符串类型
• attrib：子节点的属性字典，可选参数
• **extra：额外的属性键值对，会合并到attrib中，可选参数

基础使用示例

下面演示创建一个简单的XML结构，根节点为user，包含两个子节点name和age：

from xml.etree import ElementTree as ET

# 创建根节点
root = ET.Element("user")

# 使用SubElement为root创建子节点name
name_node = ET.SubElement(root, "name")
# 为子节点添加文本内容
name_node.text = "张三"

# 使用SubElement为root创建子节点age，同时添加属性
age_node = ET.SubElement(root, "age", {"unit": "岁"}, type="int")
age_node.text = "25"

# 生成XML字符串并打印
xml_str = ET.tostring(root, encoding="unicode")
print(xml_str)

上述代码执行后会输出：

<user><name>张三</name><age unit="岁" type="int">25</age></user>

创建多层嵌套子节点

SubElement支持链式创建多层嵌套的XML结构，父节点可以是之前创建的任意子节点：

from xml.etree import ElementTree as ET

# 创建根节点books
books = ET.Element("books")

# 为books创建子节点book
book1 = ET.SubElement(books, "book", id="1")
# 为book1创建子节点title
title1 = ET.SubElement(book1, "title")
title1.text = "Python编程入门"
# 为book1创建子节点author
author1 = ET.SubElement(book1, "author")
author1.text = "李四"

# 再创建一个book子节点
book2 = ET.SubElement(books, "book", id="2")
title2 = ET.SubElement(book2, "title")
title2.text = "XML处理实战"
author2 = ET.SubElement(book2, "author")
author2.text = "王五"

# 将结果写入文件
tree = ET.ElementTree(books)
tree.write("books.xml", encoding="utf-8", xml_declaration=True)

生成的books.xml文件内容如下：

<?xml version='1.0' encoding='utf-8'?>
<books>
    <book id="1">
        <title>Python编程入门</title>
        <author>李四</author>
    </book>
    <book id="2">
        <title>XML处理实战</title>
        <author>王五</author>
    </book>
</books>

SubElement与手动创建子节点的对比

如果不使用SubElement，手动创建子节点需要先实例化Element对象，再调用父节点的append方法，代码会更繁琐：

from xml.etree import ElementTree as ET

root = ET.Element("root")

# 手动创建子节点
child = ET.Element("child")
child.text = "测试内容"
root.append(child)

# 使用SubElement创建子节点
ET.SubElement(root, "child2").text = "测试内容2"

可以看到SubElement将创建和添加子节点的操作合并为一步，代码更简洁，可读性也更高。

注意事项

• SubElement返回的是创建完成的子节点对象，可以直接对其操作text、attrib等属性
• 如果子节点没有文本内容，不需要设置text属性，默认会生成自闭合标签或者空标签
• 属性名如果包含特殊字符或者空格，不建议使用**extra参数，直接放在attrib字典中更稳妥
• 创建XML后如果需要格式化输出，可以使用minidom模块的toprettyxml方法处理，但要注意编码问题

使用SubElement时不需要手动调用父节点的append方法，函数内部已经完成了子节点的添加操作，避免重复添加导致XML结构异常。

Pythonxml.etree.ElementTreeSubElementXML子节点创建修改时间：2026-06-15 00:30:27