Python标准库xml.etree.ElementTree不支持写入DOCTYPE，必须用lxml.etree、minidom或手拼字符串实现；其中lxml最稳妥，需用DocumentType构造并插入根元素前。
Python写XML时为什么必须手动加DOCTYPE？
因为标准库xml.etree.ElementTree默认不生成DOCTYPE——它压根不支持写入DTD引用，连write()方法都会直接跳过。你用etree.tostring()或ElementTree.write()得到的XML，哪怕原始文件里有DOCTYPE，也会被清得干干净净。
常见错误现象：xml.etree.ElementTree读入带DOCTYPE的文件后，再写出来就只剩根元素，<!DOCTYPE ...>彻底消失；用minidom写入时若没显式调用writexml()并传参，也一样丢。
- 真正能保留/插入
DOCTYPE的只有lxml.etree（需额外安装）或手拼字符串 -
minidom可以构造DocumentType节点，但必须用writexml()且传encoding和newl参数，否则格式错乱 - 手拼字符串最简单，但只适合静态内容、无动态嵌套场景
用lxml.etree插入DOCTYPE的正确姿势
lxml是目前最稳妥的选择：它把DOCTYPE当第一级节点处理，支持显式声明和外部DTD引用。
使用场景：需要校验XML结构、配合XSD/DTE做解析预处理、生成符合遗留系统要求的文档。
立即学习“Python免费学习笔记（深入）”；
- 用
lxml.etree.XMLParser(dtd_validation=True)读取时会自动加载DTD，但写入仍需手动加DOCTYPE - 写入前必须用
lxml.etree.DocumentType构造节点，并插入到doc.getroot().getparent()位置（即根元素的父节点） - Dtd URL路径要写全，比如
"http://www.example.com/dtds/app.dtd"，相对路径在解析时容易出IOError: Error reading DTD
from lxml import etree
<p>root = etree.Element("config")
doc = etree.ElementTree(root)
doctype = etree.DocumentType(root, public_id="-//Example//DTD Config 1.0//EN", system_url="config.dtd")</p><h1>插入到根元素之前</h1><p>doc._setroot(etree.ElementTree(etree.Element("dummy")).getroot()) # 先占位
doc.getroot().addprevious(doctype)</p>
minidom写DOCTYPE时最容易踩的三个坑
minidom能做，但接口反直觉：它不把DOCTYPE当普通节点，而是靠Document对象的doctype属性控制，且writexml()必须指定换行和缩进，否则DOCTYPE会挤在第一行末尾，导致解析失败。
- 不能用
appendChild()往document里加DocumentType——会报HierarchyRequestErr - 必须用
document.doctype = domimpl.createDocumentType(...)设置，且createDocumentType()三个参数缺一不可（qualifiedName、publicId、systemId） -
writexml()不传newl="\n"和encoding="utf-8"，输出的DOCTYPE会紧贴<?xml...?>，很多解析器直接拒识
from xml.dom import minidom, DOMImplementation
<p>impl = DOMImplementation()
doctype = impl.createDocumentType("config", "-//Example//DTD Config 1.0//EN", "config.dtd")
doc = impl.createDocument(None, "config", doctype)</p><h1>必须用 writexml，不能用 toxml()</h1><p>with open("out.xml", "w", encoding="utf-8") as f:
doc.writexml(f, encoding="utf-8", newl="\n")</p>手拼DOCTYPE字符串的安全边界
如果只是生成一次性的、结构固定的XML，且不涉及复杂命名空间或实体引用，直接字符串拼接最快——但仅限于DOCTYPE内容完全可控、不含用户输入的场景。
性能影响几乎为零，兼容性最好（所有XML解析器都认），但一旦DOCTYPE里出现<![ENTITY...或条件节，手拼极易引出xml.parsers.expat.ExpatError: not well-formed。
- 开头必须是
<?xml version="1.0" encoding="UTF-8"?>\n，否则某些老解析器会忽略DOCTYPE -
SYSTEM和PUBLIC声明语法不能混用；PUBLIC必须带双引号包裹的公共标识符 - 避免在
DOCTYPE里写%ent;这类参数实体——ElementTree根本不会解析，而lxml默认也不展开
比如这样安全：<!DOCTYPE config SYSTEM "config.dtd">；这样危险：<!DOCTYPE config PUBLIC "-//EX//ENT" "ent.dtd" [<!ENTITY x "<foo>">]>。
