Python怎么把ElementTree对象写入字符串

在Python的XML处理场景中，ElementTree是常用的标准库模块，用于构建、解析和操作XML结构。当我们需要把构建好的ElementTree对象转换为字符串时，核心是使用模块提供的转换方法，下面详细介绍具体实现方式。

使用tostring方法转换Element对象

如果我们的ElementTree对象是通过ElementTree.Element()构建的根元素，或者获取到的是根元素对象，可以直接使用ElementTree.tostring()方法完成转换，这个方法会返回字节类型的字符串结果。

先看一个简单的构建Element对象并转换的示例：

import xml.etree.ElementTree as ET

# 构建根元素
root = ET.Element("user")
# 添加子元素
name = ET.SubElement(root, "name")
name.text = "张三"
age = ET.SubElement(root, "age")
age.text = "25"

# 将Element对象转换为字符串
xml_str = ET.tostring(root, encoding="utf-8")
print(type(xml_str))
print(xml_str.decode("utf-8"))

运行上述代码，首先会输出<class 'bytes'>，说明tostring默认返回的是字节类型，我们可以通过decode方法将其转换为普通字符串。如果希望直接得到字符串类型，也可以指定encoding参数为"unicode"。

import xml.etree.ElementTree as ET

root = ET.Element("user")
name = ET.SubElement(root, "name")
name.text = "张三"
age = ET.SubElement(root, "age")
age.text = "25"

# 指定encoding为unicode，直接得到字符串
xml_str = ET.tostring(root, encoding="unicode")
print(type(xml_str))
print(xml_str)

转换完整的ElementTree对象

如果我们是先创建了ElementTree实例，而不是直接操作根元素，也可以通过获取根元素后再转换，或者直接使用write方法结合BytesIO来实现转换，避免额外的中间操作。

下面是使用BytesIO配合write方法转换ElementTree对象的示例：

import xml.etree.ElementTree as ET
from io import BytesIO

# 构建根元素并创建ElementTree对象
root = ET.Element("user")
name = ET.SubElement(root, "name")
name.text = "李四"
age = ET.SubElement(root, "age")
age.text = "30"
tree = ET.ElementTree(root)

# 使用BytesIO接收write的输出
buffer = BytesIO()
tree.write(buffer, encoding="utf-8", xml_declaration=True)
# 获取缓冲区内容并转换为字符串
xml_str = buffer.getvalue().decode("utf-8")
print(xml_str)

这里我们通过设置xml_declaration=True，可以在输出的字符串中包含XML声明头，默认情况下这个参数是False，不会添加声明头。如果不需要声明头，可以省略这个参数或者设置为False。

常见问题说明

• 编码问题：如果XML中包含中文等非ASCII字符，建议统一使用utf-8编码，避免出现乱码。如果转换后的字符串需要用于其他系统，要确认对方的编码要求。
• 格式美化：默认的tostring和write方法输出的XML是紧凑格式的，没有缩进。如果需要美化格式，可以手动处理，或者使用第三方库如lxml的tostring方法，设置pretty_print参数。
• 命名空间处理：如果XML元素包含命名空间，tostring方法会自动处理命名空间的前缀和定义，不需要额外操作，只需要在构建元素时正确设置命名空间即可。

方法对比

下面是两种常用转换方式的对比：

PythonElementTree字符串转换tostringXML修改时间：2026-06-27 05:51:13