XML中的BOM是什么 怎么去除XML文件开头的BOM

BOM是Unicode文件开头标识编码和字节序的特殊字节序列,XML中非必需且可能导致解析失败;常见UTF-8 BOM为EF BB BF,需通过十六进制工具检测并安全去除,推荐使用UTF-8无BOM保存或Python脚本处理。

BOM(Byte Order Mark) 是 Unicode 编码文件开头的一个特殊字节序列,用于标识文件的编码格式和字节序。在 XML 文件中,BOM 本身不是 XML 规范要求的内容,但某些编辑器(如 Windows 记事本、VS Code 默认 UTF-8 with BOM 模式)保存 UTF-8 文件时会自动添加 EF BB BF 这三个字节。XML 解析器(尤其是较老或严格遵循规范的解析器)可能将 BOM 视为非法字符,导致解析失败,报错类似“Content is not allowed in prolog”。

XML 文件开头的 BOM 长什么样

常见编码对应的 BOM 字节序列:

  • UTF-8EF BB BF(最常见,3 字节)
  • UTF-16 BEFE FF(2 字节)
  • UTF-16 LEFF FE(2 字节)
  • UTF-32 BE00 00 FE FF(4 字节)
  • UTF-32 LEFF FE 00 00(4 字节)

XML 声明(如 )必须是文件最开头内容,BOM 若存在,就占据了“最开头”,违反了 XML 规范对 prolog 的定义。

如何检测 XML 文件是否含 BOM

用十六进制编辑器或命令行工具查看文件头几个字节:

  • Linux/macOS:xxd -l 8 yourfile.xmlhexdump -C -n 8 yourfile.xml
  • Windows(PowerShell):Get-Content yourfile.xml -Encoding Byte -TotalCount 8 | ForEach-Object { $_.ToString("X2") }
  • 在线工具:搜索 “hex editor online”,粘贴文件内容或上传查看前 10 字节

若看到 ef bb bf 开头,就是 UTF-8 BOM。

安全去除 XML 文件 BOM 的方法

关键原则:只删 BOM 字节,不改动编码本身(仍保持 UTF-8),并确保 XML 声明中的 encoding 属性与实际一致(UTF-8 可省略 encoding,推荐省略)。

  • 文本编辑器方式:用 VS Code、Notepad++、Sublime Text 等打开 → 右下角点击编码名(如 “UTF-8 with BOM”)→ 选择 “Save with Encoding” → 选 “UTF-8”(不含 BOM)→ 保存
  • 命令行(Linux/macOS)sed '1s/^\xEF\xBB\xBF//' input.xml > output.xml;更通用可使用 iconviconv -f UTF-8 -t UTF-8//IGNORE input.xml > output.xml(部分系统支持)
  • Python 脚本(推荐,跨平台可靠)
    with open('input.xml', 'rb') as f:
        raw = f.read()
    if raw.startswith(b'\xef\xbb\xbf'):
        raw = raw[3:]
    with open('output.xml', 'wb') as f:
        f.write(raw)
    

预防 BOM 产生的建议

从源头避免比事后清理更可靠:

  • 编辑器设置默认保存为 “UTF-8 without BOM”(VS Code 设置中搜 files.encoding,设为 utf8;Notepad++ 设置 → 首选项 → 新建 → 编码选 “UTF-8”)
  • 生成 XML 的程序(如 Java DOM、Python xml.etree、C# XmlDocument)默认不写 BOM;若用 FileWriter/StreamWriter,显式指定无 BOM 的 UTF-8 编码(如 Java 中用 StandardCharsets.UTF_8,不带 BOM)
  • CI/CD 流程中增加校验步骤,例如用脚本扫描 XML 文件头,发现 BOM 就报错或自动修复

不复杂但容易忽略,确认 XML 文件以 直接开头,基本就没 BOM 问题了。