如何用Python写入XML文件并修改XML节点数据

在Python中操作XML文件可以通过标准库自带的xml.etree.ElementTree模块实现，该模块提供了创建、解析、修改XML文件的完整能力，无需安装额外依赖，适合大多数常规XML操作场景。无论是需要生成新的XML文件，还是修改已有XML中的节点内容，都可以通过该模块的相关方法快速完成。

一、Python写入XML文件的基本步骤

写入新的XML文件需要先构建XML的树结构，再将树写入到文件中，具体可以分为以下几个步骤：

• 导入xml.etree.ElementTree模块，通常简写为ET
• 创建根节点，作为整个XML结构的顶层元素
• 在根节点下添加子节点，设置节点的属性和文本内容
• 构建ElementTree对象，调用write方法将内容写入文件

1.1 基础写入示例

下面的代码演示了创建一个简单的用户信息XML文件的过程：

import xml.etree.ElementTree as ET

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

# 创建第一个用户子节点
user1 = ET.SubElement(root, "user")
# 设置节点属性
user1.set("id", "1")
# 添加子节点并设置文本内容
name1 = ET.SubElement(user1, "name")
name1.text = "张三"
age1 = ET.SubElement(user1, "age")
age1.text = "25"

# 创建第二个用户子节点
user2 = ET.SubElement(root, "user")
user2.set("id", "2")
name2 = ET.SubElement(user2, "name")
name2.text = "李四"
age2 = ET.SubElement(user2, "age")
age2.text = "28"

# 构建ElementTree对象
tree = ET.ElementTree(root)
# 写入文件，设置编码为utf-8，xml_declaration=True会添加XML声明头
tree.write("users.xml", encoding="utf-8", xml_declaration=True)

执行上述代码后，会生成users.xml文件，内容如下：

<?xml version='1.0' encoding='utf-8'?>
<users>
  <user id="1">
    <name>张三</name>
    <age>25</age>
  </user>
  <user id="2">
    <name>李四</name>
    <age>28</age>
  </user>
</users>

二、Python修改XML节点数据的方法

修改已有XML文件的节点数据，需要先解析原XML文件，找到目标节点后修改其属性或文本内容，最后重新写入文件即可。

2.1 修改节点文本内容

以下示例演示了将上面生成的users.xml中id为1的用户年龄修改为26：

import xml.etree.ElementTree as ET

# 解析已有XML文件
tree = ET.parse("users.xml")
# 获取根节点
root = tree.getroot()

# 遍历所有user节点
for user in root.findall("user"):
    # 获取user节点的id属性
    user_id = user.get("id")
    if user_id == "1":
        # 找到age子节点
        age_node = user.find("age")
        if age_node is not None:
            # 修改age节点的文本内容
            age_node.text = "26"

# 将修改后的内容重新写入文件
tree.write("users.xml", encoding="utf-8", xml_declaration=True)

2.2 修改节点属性

如果需要修改节点的属性，比如将id为2的用户节点的id属性改为3，可以参考以下代码：

import xml.etree.ElementTree as ET

tree = ET.parse("users.xml")
root = tree.getroot()

for user in root.findall("user"):
    if user.get("id") == "2":
        # 修改user节点的id属性
        user.set("id", "3")

tree.write("users.xml", encoding="utf-8", xml_declaration=True)

2.3 添加新节点到已有XML

除了修改已有节点，还可以在已有XML中添加新的子节点，比如给users.xml添加一个新的用户节点：

import xml.etree.ElementTree as ET

tree = ET.parse("users.xml")
root = tree.getroot()

# 创建新的user节点
new_user = ET.SubElement(root, "user")
new_user.set("id", "3")
# 添加子节点
name = ET.SubElement(new_user, "name")
name.text = "王五"
age = ET.SubElement(new_user, "age")
age.text = "30"

# 写入文件
tree.write("users.xml", encoding="utf-8", xml_declaration=True)

三、操作注意事项

• 写入XML文件时，如果设置xml_declaration=True，会自动添加<?xml version='1.0' encoding='utf-8'?>声明，避免中文乱码问题
• 使用find方法查找节点时，只会返回第一个匹配的子节点，如果需要查找所有匹配的节点，要使用findall方法
• 修改XML文件后，必须重新调用write方法写入，否则修改不会保存到文件中
• 如果XML文件结构比较复杂，包含命名空间，查找节点时需要带上完整的命名空间前缀，否则会找不到目标节点

注意：ElementTree模块处理非常大的XML文件时效率会有所下降，如果有超大XML文件的操作需求，可以考虑使用lxml库的iterparse方法实现增量解析。

四、常见问题解决

如果在操作过程中遇到找不到节点的问题，可以先打印根节点的标签名，确认解析的文件是否正确，也可以遍历所有子节点查看结构是否符合预期：

import xml.etree.ElementTree as ET

tree = ET.parse("users.xml")
root = tree.getroot()
# 打印根节点标签
print("根节点标签:", root.tag)
# 遍历所有子节点
for child in root:
    print("子节点标签:", child.tag, "属性:", child.attrib)

通过上述方法可以快速定位XML结构问题，排查节点查找失败的原因。

PythonXML写入XML节点修改ElementTree修改时间：2026-07-08 00:42:29