XML声明必须位于文件首行且无任何前导字符（含空格、BOM、换行），格式为，version必须为"1.0"，encoding须与实际编码严格一致且大小写敏感，声明后须紧接根元素，中间不可有空行或注释。
XML声明必须出现在第一行且不能有前导空格或BOM
XML声明不是必需的，但一旦出现，就必须是文件最开头的字符，前面不能有任何内容（包括空格、换行、UTF-8 BOM）。常见错误是编辑器自动插入BOM或复制粘贴时带入不可见字符，导致解析失败，报错类似 ParseError: not well-formed (invalid token) 或 XML declaration not at start of document。
- 正确写法：
- 错误写法（开头有空格）：
- 错误写法（含UTF-8 BOM）：用十六进制查看器可见开头三个字节
EF BB BF，需用编辑器“另存为无BOM UTF-8”清除
version 和 encoding 参数缺一不可，standalone 是可选的
version 必须是 "1.0"（XML 1.1 已基本弃用，现代工具普遍不支持）；encoding 必须与实际文件编码严格一致——如果文件是UTF-8但声明为 encoding="GBK"，解析器会按GBK解码UTF-8字节，产生乱码或崩溃；standalone 只在涉及外部DTD时才有意义，日常几乎不用，建议省略。
- 推荐最小合法声明：
- 不要写
version="1.1"：Pythonxml.etree.ElementTree、浏览器DOMParser、libxml2 等主流解析器默认不认 - 不要写
encoding="utf8"：必须是"UTF-8"（大小写敏感，且带连字符）
XML声明后面必须紧跟根元素，中间不能有空行或注释
XML声明和根元素之间不能插入任何字符，包括换行符、空格、XML注释 。否则解析器会把换行当作文本节点，而XML文档要求有且仅有一个根元素，导致“multiple root elements”错误。
- 正确结构：
- 错误结构（声明后换行）：
→ 实际开头变成\n，首字符是换行符，违反“声明必须在第一行”规则 - 错误结构（声明后加注释）：
→ 解析器会报Unexpected token，因为注释不属于声明一部分
用Python验证XML声明是否合规
手动检查容易遗漏BOM或不可见字符，可以用Python快速验证：
with open("data.xml", "rb") as f:
raw = f.read(100) # 只读前100字节
if raw.startswith(b"\xef\xbb\xbf"):
print("ERROR: UTF-8 BOM detected")
if raw.startswith(b"BOM和换行问题比语法错误更隐蔽，尤其在跨平台协作中——Windows记事本、某些IDE默认加BOM，而Linux命令行工具（如 curl、sed）对BOM完全不感知，结果就是本地能跑、CI上挂掉。
