如何使用 Python 向现有 XML 文件追加数据

在使用Python处理XML文件时，向现有文件追加数据是一个常见的需求，比如需要在已有的配置文件中添加新的配置项，或者在数据存储的XML文件中补充新的记录。Python的标准库提供了xml.etree.ElementTree模块，能够很方便地实现XML文件的解析、修改和保存操作。

准备工作

首先需要确保Python环境已经安装，本文使用的示例基于Python3.6及以上版本，不需要额外安装第三方库，直接使用标准库即可。假设我们有一个现有的XML文件data.xml，内容如下：

<root>
    <user>
        <id>1</id>
        <name>张三</name>
        <age>25</age>
    </user>
    <user>
        <id>2</id>
        <name>李四</name>
        <age>28</age>
    </user>
</root>

解析现有XML文件

使用xml.etree.ElementTree模块的parse方法可以解析已有的XML文件，得到ElementTree对象和根节点，后续的操作都基于这两个对象进行。

import xml.etree.ElementTree as ET

# 解析现有XML文件
tree = ET.parse('data.xml')
# 获取根节点
root = tree.getroot()

构建新的数据节点

根据XML文件的结构，我们需要构建符合格式的新节点。以上面的data.xml为例，新增的用户节点需要包含id、name、age三个子节点。

# 创建新的user节点
new_user = ET.Element('user')

# 创建id子节点并设置内容
id_node = ET.SubElement(new_user, 'id')
id_node.text = '3'

# 创建name子节点并设置内容
name_node = ET.SubElement(new_user, 'name')
name_node.text = '王五'

# 创建age子节点并设置内容
age_node = ET.SubElement(new_user, 'age')
age_node.text = '30'

追加新节点并保存文件

将构建好的新节点追加到根节点下，然后使用tree.write方法将修改后的内容保存到原文件或者新文件中。需要注意的是，写入时可以指定编码格式，避免中文乱码问题。

# 将新节点追加到根节点下
root.append(new_user)

# 保存修改后的内容到原文件，指定编码为utf-8，xml_declaration=True会添加XML声明头
tree.write('data.xml', encoding='utf-8', xml_declaration=True)

完整示例代码

将上面的步骤整合起来，得到完整的可运行代码：

import xml.etree.ElementTree as ET

def append_xml_data(file_path, new_data):
    # 解析现有XML文件
    tree = ET.parse(file_path)
    root = tree.getroot()
    
    # 构建新的user节点
    new_user = ET.Element('user')
    for key, value in new_data.items():
        child = ET.SubElement(new_user, key)
        child.text = str(value)
    
    # 追加新节点
    root.append(new_user)
    
    # 保存文件
    tree.write(file_path, encoding='utf-8', xml_declaration=True)
    print(f"数据已成功追加到{file_path}")

if __name__ == '__main__':
    # 新数据内容
    new_record = {
        'id': 3,
        'name': '王五',
        'age': 30
    }
    append_xml_data('data.xml', new_record)

注意事项

• 如果XML文件包含命名空间，解析和构建节点时需要正确处理命名空间前缀，否则可能导致节点格式错误。
• 写入文件时如果不指定xml_declaration=True，原文件的XML声明头可能会丢失，建议根据需求设置该参数。
• 如果追加的数据量较大，频繁解析和写入文件会影响性能，可以考虑先将所有新节点构建完成后再一次性写入。
• 操作前建议备份原XML文件，避免代码逻辑错误导致原文件内容损坏。

PythonXMLElementTree数据追加文件操作修改时间：2026-07-01 10:12:25