在C#中通过LINQ to XML的XDocument对象保存XML文件时，如果直接调用Save方法并指定UTF-8编码，往往会在文件开头写入一个BOM（字节顺序标记）。这个BOM虽然对多数文本编辑器不可见，但在一些严格按字节解析的接口或老旧系统中会导致解析失败。要解决这个问题，关键在于控制底层XmlWriter使用的Encoding对象是否带BOM。
为什么XDocument Save会带BOM
当使用如下简单写法时：
using System.Xml.Linq;
XDocument doc = new XDocument(new XElement("root", "value"));
doc.Save("test.xml"); // 默认UTF-8并带BOM
内部会使用Encoding.UTF8，而该静态属性返回的UTF-8编码实例默认带BOM。因此生成的文件前三个字节为EF BB BF。
使用XmlWriter自定义无BOM输出
我们可以创建一个不带BOM的UTF-8编码，并配置XmlWriterSettings来写入文件。示例如下：
using System;
using System.IO;
using System.Text;
using System.Xml;
using System.Xml.Linq;
class Program
{
static void Main()
{
XDocument doc = new XDocument(
new XDeclaration("1.0", "utf-8", null),
new XElement("root", new XElement("item", "hello"))
);
// 创建无BOM的UTF-8编码
Encoding utf8NoBom = new UTF8Encoding(false);
XmlWriterSettings settings = new XmlWriterSettings
{
Encoding = utf8NoBom,
Indent = true,
OmitXmlDeclaration = false
};
using (XmlWriter writer = XmlWriter.Create("test_nobom.xml", settings))
{
doc.Save(writer);
}
Console.WriteLine("文件已保存为无BOM UTF-8");
}
}
上面的new UTF8Encoding(false)表示不输出BOM。将settings传给XmlWriter.Create后，再用XDocument的Save方法写入，即可避免BOM头。
通过MemoryStream验证是否带BOM
如果你希望在内存中确认输出内容无BOM，可以使用MemoryStream配合StreamReader检查：
using System;
using System.IO;
using System.Text;
using System.Xml;
using System.Xml.Linq;
XDocument doc = new XDocument(new XElement("data", "123"));
Encoding utf8NoBom = new UTF8Encoding(false);
XmlWriterSettings settings = new XmlWriterSettings { Encoding = utf8NoBom };
using (MemoryStream ms = new MemoryStream())
{
using (XmlWriter writer = XmlWriter.Create(ms, settings))
{
doc.Save(writer);
}
byte[] bytes = ms.ToArray();
bool hasBom = bytes.Length >= 3 && bytes[0] == 0xEF && bytes[1] == 0xBB && bytes[2] == 0xBF;
Console.WriteLine("是否包含BOM: " + hasBom);
}
注意事项
- 若使用
File.WriteAllText直接写字符串，也建议传入new UTF8Encoding(false)。 - XDeclaration中的encoding值仅为声明文本，不影响实际字节流是否含BOM。
- 某些Web接口要求严格无BOM，部署前可用十六进制工具抽查文件头。
通过上述方式，你可以稳定地使用XDocument生成符合要求的无BOM UTF-8 XML文件，避免不必要的兼容问题。