Python ElementTree处理XML时如何保留原命名空间？

你遇到的这个问题确实是ElementTree的一个常见痛点——它在序列化XML时会自动把未注册的命名空间前缀替换成ns0、ns1这类默认前缀，甚至会把默认命名空间也强制加上前缀。下面分场景给你具体的解决办法：

一、处理自定义命名空间前缀（已知前缀和URI） #

如果提前知道XML里用到的命名空间前缀和对应的URI，直接用ET.register_namespace()就能解决，注意要在解析XML之前就注册所有需要保留的前缀：

import xml.etree.ElementTree as ET

# 先注册所有需要保留的命名空间前缀与对应URI
ET.register_namespace('prefix', 'URI')
ET.register_namespace('company', '这里填company前缀对应的实际URI')

# 再解析并修改XML
tree = ET.parse('filename.xml')
root = tree.getroot()
# 示例修改操作：更新child的company:name属性
root.find('.//child').attrib['company:name'] = 'new_company_name'

# 保存修改，指定编码和XML声明更规范
tree.write('filename.xml', encoding='utf-8', xml_declaration=True)

这样处理后，自定义前缀就不会被替换成ns0了。

二、处理默认命名空间（无前缀的命名空间） #

对于<root xmlns="http://uri">这类默认命名空间，ElementTree默认会把它转换成带ns0前缀的形式，要保留原写法，有两种可靠方案：

方法1：利用Python 3.8+的default_namespace参数 #

如果你的Python版本是3.8及以上，ET.ElementTree.write()方法新增了default_namespace参数，直接指定默认命名空间的URI即可：

import xml.etree.ElementTree as ET

tree = ET.parse('filename.xml')
root = tree.getroot()
# 示例修改操作：更新child的name属性
root.find('.//child').attrib['name'] = 'updated_child_name'

# 保存时指定default_namespace为原默认命名空间的URI
tree.write('filename.xml', encoding='utf-8', xml_declaration=True, default_namespace='http://uri')

这样生成的XML会保留<root xmlns="http://uri">的形式，不会给根元素和子元素加ns0前缀。

方法2：手动修改命名空间映射（兼容旧Python版本） #

如果你的Python版本低于3.8，可以通过修改元素标签和手动设置xmlns属性来实现：

import xml.etree.ElementTree as ET

tree = ET.parse('filename.xml')
root = tree.getroot()

# 获取默认命名空间的URI（空字符串对应的就是默认命名空间）
default_uri = root.nsmap.get('')
if default_uri:
    # 把根元素的带命名空间标签（格式为{URI}root）还原成普通标签
    root.tag = root.tag.split('}')[-1]
    # 手动给根元素加上默认命名空间属性
    root.set('xmlns', default_uri)
    
    # 遍历所有子元素，去掉它们的命名空间前缀
    for elem in root.iter():
        if '}' in elem.tag:
            elem.tag = elem.tag.split('}')[-1]

# 执行你的修改操作
# ...

# 保存修改
tree.write('filename.xml', encoding='utf-8', xml_declaration=True)

这个方法的核心是剥离所有元素标签中的命名空间前缀，再手动给根元素添上默认命名空间属性，这样序列化后就能保留原格式。

三、通用技巧：自动注册所有解析到的命名空间 #

如果你不想提前手动注册所有命名空间，可以在解析XML后，自动提取所有存在的命名空间映射并批量注册：

import xml.etree.ElementTree as ET

def register_all_namespaces(tree):
    root = tree.getroot()
    # 提取根元素的所有命名空间映射
    nsmap = root.nsmap
    for prefix, uri in nsmap.items():
        if prefix:  # 跳过默认命名空间（空前缀）
            ET.register_namespace(prefix, uri)

# 解析XML
tree = ET.parse('filename.xml')
# 自动注册所有命名空间
register_all_namespaces(tree)

# 执行修改操作
# ...

# 保存修改
tree.write('filename.xml', encoding='utf-8', xml_declaration=True)

这个方法可以避免遗漏命名空间，结合上面的默认命名空间处理方案，就能完美保留原XML的命名空间结构。

内容的提问来源于stack exchange，提问作者rez