在C#里读写文本文件，编码问题常常被忽略，直到文件在另一台机器或另一个编辑器中打开出现乱码才被发现。UTF-8是目前最通用的文本编码，但.NET中不同API对编码的默认处理并不一致，显式指定编码是避免问题的最直接手段。接下来会结合File类、StreamReader、StreamWriter的使用，说明如何正确设置UTF-8编码，并解释带BOM与不带BOM的实际差异。
为什么文件编码会引发乱码
文本文件存储的是字节序列，而字符需要通过某种编码规则转换成字节。读取时如果使用了错误的编码解码，字节和字符的映射就会错乱，表现就是乱码。C#的System.Text.Encoding类提供了多种编码对象，其中Encoding.UTF8代表UTF-8编码。需要注意的是，Encoding.UTF8返回的实例默认会在写入时输出UTF-8 BOM（字节顺序标记），即文件开头的三个字节EF BB BF。这个BOM可以帮一些编辑器识别编码，但并非所有环境都欢迎它，比如Linux下的一些工具可能把BOM当作普通字符处理。
UTF-8是一种变长编码，ASCII字符只占一个字节，中文通常占三个字节。它兼容ASCII，因此在处理纯英文文本时与ASCII编码结果一致，但遇到中文等多字节字符时必须确保读写双方使用同样的编码。如果写入时用GBK，读取时用UTF-8，中文字符就会变成乱码。所以显式指定编码能消除依赖系统默认值的风险。
使用File静态类读写文件时指定UTF-8
File.ReadAllText和File.WriteAllText是读写小文本文件最常用的方法。它们的重载版本允许传入一个Encoding对象。如果不传编码参数，不同.NET版本的默认行为可能不同，建议始终显式传入Encoding参数。
string path = @"C:\temp\demo.txt"; string content = "你好，世界"; // 写入时指定UTF-8编码 File.WriteAllText(path, content, Encoding.UTF8); // 读取时指定UTF-8编码 string readContent = File.ReadAllText(path, Encoding.UTF8);
上面的代码使用了Encoding.UTF8，它会写入BOM。如果不希望产生BOM，应该使用new UTF8Encoding(false)来创建不带BOM的UTF-8编码实例，然后传给读写方法。下文会详细说明。
另外，File.AppendAllText也有类似重载，可以在追加文本时指定编码，避免追加内容与原有内容编码不一致导致乱码。
使用StreamReader和StreamWriter精细控制编码
StreamWriter和StreamReader适合处理大文件或需要流式读写的场景。创建StreamWriter时可以通过构造函数指定编码。默认构造函数如果不指定编码，在.NET Core中使用UTF-8无BOM，但为了代码可移植性，建议显式传入。
string path = @"C:\temp\bom.txt";
string noBomPath = @"C:\temp\nobom.txt";
// 带BOM的UTF-8
using (var writer = new StreamWriter(path, false, Encoding.UTF8))
{
writer.WriteLine("包含BOM的内容");
}
// 不带BOM的UTF-8
using (var writer = new StreamWriter(noBomPath, false, new UTF8Encoding(false)))
{
writer.WriteLine("不包含BOM的内容");
}
读取时，StreamReader默认会检测BOM，如果文件开头有BOM，它会自动使用对应编码读取；如果没有BOM，默认按UTF-8处理。但如果不确定文件编码，可以显式指定编码参数：
using (var reader = new StreamReader(path, Encoding.UTF8))
{
string line;
while ((line = reader.ReadLine()) != null)
{
Console.WriteLine(line);
}
}
需要注意的是，StreamReader构造函数中的编码参数主要用于没有BOM时指定解码方式，如果文件有BOM，则BOM优先级更高。因此想强制按某种编码读取时，最好先去除BOM或使用StreamReader的detectEncodingFromByteOrderMarks参数设为false，但一般不建议这样做，除非你明确知道文件编码。
BOM的实际影响与最佳实践
BOM的存在有利有弊。Windows记事本等工具依赖BOM识别UTF-8，如果缺少BOM，可能会以ANSI编码打开导致中文乱码；而许多Linux工具、脚本解释器以及一些跨平台构建系统则不喜欢BOM，它们可能把BOM字符当作内容的一部分，造成解析错误。因此需要根据目标环境决定是否写入BOM。
检测文件是否带UTF-8 BOM很简单，读取前三个字节判断是否为0xEF, 0xBB, 0xBF。示例代码：
byte[] bytes = File.ReadAllBytes(path); bool hasUtf8Bom = bytes.Length >= 3 && bytes[0] == 0xEF && bytes[1] == 0xBB && bytes[2] == 0xBF; Console.WriteLine(hasUtf8Bom ? "带UTF-8 BOM" : "不带UTF-8 BOM");
在跨平台项目中，一种常见的最佳实践是使用new UTF8Encoding(false)读写文件，确保不产生BOM，同时所有读写操作显式指定该编码对象。例如可以定义一个静态只读字段：
public static readonly Encoding Utf8NoBom = new UTF8Encoding(false); // 使用 File.WriteAllText(path, content, Utf8NoBom); string text = File.ReadAllText(path, Utf8NoBom);
这样既能保证编码一致，又避免BOM带来的兼容性问题。如果需要兼容Windows记事本，则保留BOM。对于源文件、配置文件、日志等场景，根据实际需求选择。
常见陷阱与调试方法
调试编码问题可以借助十六进制查看器或读取字节数组检查。如果发现写入正常但读取乱码，先确认文件实际字节编码，再确认读取时指定的编码。例如用File.ReadAllBytes读取字节，然后输出前几个字节，判断BOM和编码类型。
另一个常见陷阱是字符串内部包含转义字符，例如反斜杠路径中的\n可能被误解为换行。在C#字符串中，反斜杠是转义字符，所以表示路径时要么使用双反斜杠\\，要么使用逐字字符串@"C:\temp"。这与文件编码无关，但容易在示例代码中引发混淆。
最后，牢记在读写文件时显式指定Encoding参数，可以让行为不受操作系统区域设置影响，提升程序的健壮性。
C#文件编码UTF-8编码StreamWriter修改时间：2026-10-07 01:22:16