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-8:
EF BB BF(最常见,3 字节) -
UTF-16 BE:
FE FF(2 字节) -
UTF-16 LE:
FF FE(2 字节) -
UTF-32 BE:
00 00 FE FF(4 字节) -
UTF-32 LE:
FF FE 00 00(4 字节)
XML 声明(如 )必须是文件最开头内容,BOM 若存在,就占据了“最开头”,违反了 XML 规范对 prolog 的定义。
如何检测 XML 文件是否含 BOM
用十六进制编辑器或命令行工具查看文件头几个字节:
- Linux/macOS:
xxd -l 8 yourfile.xml或hexdump -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;更通用可使用iconv:iconv -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 问题了。










