lxml.builder.e.tag 比 etree.element() 更快，因其是预配置工厂对象，直接返回带命名空间和属性的 element，省去手动设置三步；但需注意属性名合法性、命名空间显式声明、避免与 subelement 混用及文本转义。
lxml.builder.E.tag 为什么比 etree.Element() 更快写标签
因为 E 是一个预配置的工厂对象，调用 E.tag() 直接返回带命名空间和属性的 Element，省去手动设置 tag、attrib、text 的三步操作。它不是语法糖，是 lxml 内部做了缓存和路径优化的轻量构造器。
常见错误是把它当普通函数乱传参数：比如 E.div("hello", id="123", cls="btn") 看似合理，但 cls 不是合法 XML 属性名（XML 不认下划线或保留字），实际会变成 cls="btn" 这个属性——虽然解析器不报错，但下游系统可能忽略它。
-
E接受任意标签名，但属性名必须是合法 Python 标识符；含连字符的属性（如data-id）得写成**{"data-id": "123"} - 文本内容只能作为第一个位置参数传入，不能写成
E.p(text="xxx")—— 这样text会被当成属性键，值为"xxx"，而真实文本为空 - 嵌套结构必须靠函数调用链，比如
E.div(E.h1("Title"), E.p("Content"))，不能用+或append()
处理命名空间时 E.tag() 容易漏掉 xmlns 声明
直接用 E.svg() 生成的元素没有 xmlns 属性，浏览器或校验工具会认为它不属于 SVG 命名空间，渲染失败或被拒绝解析。这不是 E 的 bug，而是它默认不自动注入命名空间——你得显式传进去。
正确做法是把命名空间 URI 作为关键字参数传给 E.tag，键名为 xmlns 或带前缀的 xmlns:svg。但注意：xmlns 必须出现在根元素上，子元素继承即可，重复声明反而可能触发解析警告。
立即学习“Python免费学习笔记（深入）”；
- 根元素带默认命名空间：
E.svg("content", xmlns="http://www.w3.org/2000/svg") - 带前缀的命名空间：
E["svg:svg"]("content", **{"xmlns:svg": "http://www.w3.org/2000/svg"})（这里用了E["prefix:tag"]语法） - 混用多个命名空间时，不要在每个元素都写
xmlns:xxx，只在首次使用该前缀的元素上声明
和 etree.SubElement() 混用会导致 parent 关系丢失
E.tag() 返回的是孤立节点，不绑定 parent；而 etree.SubElement(parent, "tag") 显式挂载到父节点。如果先用 E 构建子树，再试图用 SubElement 往里塞，会报 ValueError: Parent element is not an Element —— 因为 E 构造的节点虽是 Element 实例，但没被任何树管理。
典型误用场景：想“先搭结构再挂载”，结果发现 doc.append(E.root(E.child())) 没问题，但 etree.SubElement(doc, "child") 就不行，因为 doc 是空的 Element，还没被解析器初始化上下文。
- 要么全程用
E链式构建整棵树（推荐用于静态结构） - 要么先用
etree.Element()创建根，再用E构建子片段，最后用.append()或.extend()手动挂载 - 避免对同一个节点既用
E又用SubElement，容易出现AssertionError: Element has no parent
中文文本或特殊字符未转义导致 XML 解析失败
E.tag("内容") 看似没问题，但如果字符串含 &、、<code>> 或控制字符（如 \x00），lxml 默认不会帮你转义——它信任你传入的是已清理过的文本。一旦有 或未闭合的 <span></span>，序列化后就是非法 XML，etree.tostring() 可能静默截断，或解析时报 XMLSyntaxError: Entity 'nbsp' not defined。
这不是 E 的责任范围，但新手常以为“我用了 lxml 就该自动处理”。实际上，lxml 把转义逻辑交给用户控制，以便兼容 CDATA、预转义 HTML 片段等复杂场景。
- 纯文本内容建议先用
html.escape()（Python 3.2+）处理，再传给E.tag() - 若需保留 HTML 标签，改用
etree.fromstring()解析后再挂载，别直接塞字符串 - 含 Unicode 的文件保存时，确保
encoding参数设为"utf-8"，否则tostring()可能抛UnicodeEncodeError
最麻烦的其实是混合场景：比如用 E 快速生成骨架，再往里填用户输入的富文本。这时候转义时机、层级归属、命名空间传播，全得自己心里有数——工具再顺手，也不能替你做语义判断。
