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。

• 正确写法：

  <?xml version="1.0" encoding="UTF-8"?>

• 错误写法（开头有空格）：

   <?xml version="1.0" encoding="UTF-8"?>

• 错误写法（含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时才有意义，日常几乎不用，建议省略。

• 推荐最小合法声明：

  <?xml version="1.0" encoding="UTF-8"?>

• 不要写 version="1.1"：Python xml.etree.ElementTree、浏览器DOMParser、libxml2 等主流解析器默认不认
• 不要写 encoding="utf8"：必须是 "UTF-8"（大小写敏感，且带连字符）

XML声明后面必须紧跟根元素，中间不能有空行或注释

XML声明和根元素之间不能插入任何字符，包括换行符、空格、XML注释 。否则解析器会把换行当作文本节点，而XML文档要求有且仅有一个根元素，导致“multiple root elements”错误。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• 正确结构：

  <?xml version="1.0" encoding="UTF-8"?><root><item></item></root>

• 错误结构（声明后换行）：

  <?xml version="1.0" encoding="UTF-8"?><root></root>

  → 实际开头变成 \n，首字符是换行符，违反“声明必须在第一行”规则
• 错误结构（声明后加注释）：

  <?xml version="1.0" encoding="UTF-8"?><!-- config --><root></root>

  → 解析器会报 Unexpected token，因为注释不属于声明一部分

用Python验证XML声明是否合规

手动检查容易遗漏BOM或不可见字符，可以用Python快速验证：

curl