C#无BOM的UTF-8 C#如何保存为不带BOM的UTF8文件

encoding.utf8 默认带 bom 是因 .net 设计将无参 utf8encoding 构造设为启用 bom；需用 new utf8encoding(false) 创建无 bom 编码器，并在 file.writealltext、streamwriter 等处显式传入，避免误用 encoding.utf8。

为什么用 Encoding.UTF8 写文件会带 BOM？

Encoding.UTF8 是 .NET 中的默认 UTF-8 编码实例，但它内部启用了 BOM（Byte Order Mark），即开头三个字节 0xEF 0xBB 0xBF。这不是 bug，而是 .NET 的设计选择——它把 UTF8Encoding 的无参构造函数设为默认带 BOM。

如何创建真正无 BOM 的 UTF-8 编码器？

必须显式使用 new UTF8Encoding(false) 构造实例，第二个参数 false 表示不写 BOM：

var noBomUtf8 = new UTF8Encoding(false); File.WriteAllText("data.txt", "你好世界", noBomUtf8);

常见错误包括：

• 误用 Encoding.UTF8（它等价于 new UTF8Encoding(true)）
• 在 StreamWriter 中只传 Encoding.UTF8，没意识到它带 BOM
• 用 File.WriteAllLines 时没传编码参数，走默认 Encoding.UTF8

用 StreamWriter 时怎么确保无 BOM？

关键在于构造 StreamWriter 时传入无 BOM 的 UTF8Encoding 实例，而不是依赖字符串重载：

using (var sw = new StreamWriter("output.json", false, new UTF8Encoding(false))) {     sw.Write("{"name":"张三"}"); }

注意点：

• 不要写成 new StreamWriter(path, false, Encoding.UTF8)
• 如果用 StreamWriter(path, append: true) 追加内容，也要确保编码一致，否则可能混入 BOM 到中间
• .NET Core 3.0+ 和 .NET 5+ 中，File.CreateText(path) 默认仍带 BOM，不能省略编码参数

验证文件是否真无 BOM？

最直接的方式是用十六进制查看器或命令行检查头几个字节：

xxd -l 8 data.txt   # Linux/macOS # 输出应为：00000000: e4fda0 e4b896 0a                      .......

如果看到 ef bb bf 开头，说明仍有 BOM。windows 上可用 PowerShell 快速验证：

Get-Content data.txt -Encoding Byte | Select-Object -First 3

输出若为 239, 187, 191，就是 BOM（对应 0xEF 0xBB 0xBF）。

很多人改了代码却没生效，是因为缓存了旧文件、ide 自动转码、或者 git 的 auto-crlf 干扰——务必用二进制工具确认实际字节，别只看文本编辑器显示。