XML声明必须顶格，即<?xml version="1.0" encoding="UTF-8"?>须位于文件首行首列，前面严禁空格、制表符、换行符或BOM；否则解析器报错，如“XML declaration not at start of document”。
XML声明必须顶格，首行开头不能有空白字符
是的，<?xml version="1.0" encoding="UTF-8"?> 这一行必须从文件最开头（第1行第1列）开始，前面**不能有任何空格、制表符、换行符或BOM**。否则解析器会直接报错，比如 ParseError: not well-formed (invalid token) 或 XML declaration not at start of document。
常见错误现象：看不见的字符导致解析失败
很多编辑器（尤其是 Windows 下的记事本、某些 IDE 的自动 BOM 插入）会在 UTF-8 文件开头悄悄加一个 EF BB BF（BOM）。虽然肉眼不可见，但 XML 解析器会把它当作非法字符处理，报错位置常显示在第1行第1列——其实问题就出在这“看不见的开头”上。
- 用
hexdump -C file.xml | head -n 1检查前几个字节，看到ef bb bf就说明有 BOM - VS Code 默认保存 UTF-8 不带 BOM；但 Sublime Text / Notepad++ 可能默认带，需手动选 “UTF-8 without BOM”
- Python 用
open("file.xml", "r", encoding="utf-8-sig")读取可自动剥离 BOM，但写入时仍要避免生成它
为什么 XML 规范强制要求声明顶格
XML 1.0 规范明确指出：XML 声明（如果存在）必须是文档的**第一个生产项**（production），且前面不得有任何字符。这是为了确保解析器能无歧义地识别编码、版本等元信息——一旦开头有空白，解析器无法确定该跳过多少、是否属于注释或处理指令，干脆禁止更稳妥。
- 即使你省略了
<?xml ...?>，只要文件以<开头，也必须顶格；否则开头空格会让解析器误以为是文本节点 -
<?xml?>本身不是处理指令（PI），它是语法层面的“文档序言”，地位特殊，不遵守 PI 的宽松规则 - 浏览器、
libxml2、lxml、DOMDocument全部严格遵循此限制，没有兼容模式
实际操作：安全生成和验证 XML 头部的方法
别靠肉眼检查空格，用工具链守住底线：
- 生成时用
echo -n '<?xml version="1.0" encoding="UTF-8"?>' > file.xml（-n防止自动换行） - 写脚本输出 XML，务必确保第一行
print("<?xml ...?>")是代码中第一个输出语句，前面没print()或日志 - CI 中加校验：用
head -c 5 file.xml | grep -q '^<?xml'，失败则拒绝提交 - 用
xmllint --noout file.xml快速验证合法性，比人工试错快得多
真正麻烦的不是“要不要顶格”，而是那些藏在编辑器设置里、Git 自动转换中、模板引擎渲染前的隐式空格——它们不会报错，直到某天换了解析器或升级了环境才突然崩掉。
