如何用Python3的lxml库创建带命名空间的XML根节点？

这个问题我之前也碰到过，lxml对命名空间的处理有严格规范，直接写带冒号的标签名会被判定为无效，咱们一步步来搞定：

核心思路 #

lxml中，带命名空间前缀的节点需要先绑定命名空间URI与前缀，再通过「命名空间URI+本地名」的方式创建节点，而不是直接拼接前缀和标签名。

具体实现步骤 #

1. 导入模块并定义命名空间URI #

首先导入lxml.etree，然后定义两个命名空间的URI：

from lxml import etree

# 定义两个命名空间的URI
cbnp_message_ns = "some_value"  # 对应cbnp-message前缀的命名空间
default_ns = "some_value2"      # 默认命名空间xmlns="..."

2. 注册命名空间前缀 #

用register_namespace方法注册前缀与URI的映射，这样生成XML时会使用你指定的前缀，而不是lxml自动生成的ns0这类默认前缀：

# 注册命名空间前缀
etree.register_namespace("cbnp-message", cbnp_message_ns)

3. 创建带前缀的根节点 #

这里有两种常用方式：

方式一：使用QName类（更清晰）

QName可以明确将命名空间URI和本地标签名组合，避免手动拼接字符串出错：

# 创建根节点，同时指定默认命名空间
root = etree.Element(etree.QName(cbnp_message_ns, "cbnp-message"), nsmap={None: default_ns})

方式二：直接使用{URI}localname格式

如果不想用QName，也可以直接用大括号包裹命名空间URI，后面跟本地标签名：

# 直接拼接命名空间URI和本地名
root = etree.Element(f"{{{cbnp_message_ns}}}cbnp-message", nsmap={None: default_ns})

4. 测试生成XML #

添加一些子节点测试，然后输出XML内容：

# 示例：添加一个默认命名空间下的子节点
child = etree.SubElement(root, "test-child")
child.text = "Hello World"

# 生成XML字符串并打印
xml_str = etree.tostring(root, encoding="UTF-8", pretty_print=True, xml_declaration=True).decode()
print(xml_str)

运行后会输出符合要求的XML：

<?xml version='1.0' encoding='UTF-8'?>
<cbnp-message:cbnp-message xmlns:cbnp-message="some_value" xmlns="some_value2">
  <test-child>Hello World</test-child>
</cbnp-message:cbnp-message>

关键说明 #

• 不能直接写"cbnp-message:cbnp-message"作为标签名，因为lxml会把冒号当成普通字符处理，导致标签名无效报错。
• nsmap={None: default_ns}用于设置默认命名空间，对应xmlns="some_value2"。
• register_namespace必须在创建节点前调用，否则生成的XML会用自动前缀（如ns0）而不是你指定的cbnp-message。

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