C#写入TXT文件时中文乱码如何解决？

Question

在C#中使用 `File.WriteAllText("test.txt", "你好世界")` 写入中文时，若未显式指定编码，.NET 默认采用 UTF-8（.NET 5+）或系统本地编码（如 GB2312/GBK，旧版 .NET Framework），易导致跨平台或编辑器（如记事本、VS Code）打开时显示乱码。常见误区是忽略编码参数，误以为“写进去就能正常显示”。根本原因在于：文本文件本身无元数据标识编码，解析端需与写入端编码严格一致。例如，用 `Encoding.Default`（通常是 GBK）写入，却用 UTF-8 解析，必然乱码；反之亦然。此外，`StreamWriter` 构造时不传 `Encoding` 参数、`File.AppendAllText` 未指定编码、或手动 `FileStream` + `StreamWriter` 混用不同编码，均会引发该问题。解决方案统一且明确：**始终显式指定编码（推荐 `Encoding.UTF8`），并确保读写两端一致**——尤其注意 UTF-8 是否含 BOM（`new UTF8Encoding(true)` 生成带BOM文件，兼容性更好；`UTF8Encoding(false)` 更标准但部分旧软件识别不佳）。

Answer 1

```html

一、现象层：乱码的直观表现与典型场景

在 Windows 记事本中打开 test.txt 显示为“浣犲ソ涓栫晫”，而 VS Code 默认以 UTF-8 解析却显示正常；Linux 终端用 cat test.txt 出现 符号；.NET 6 程序读取该文件后反序列化 JSON 失败——这些均是编码不一致的典型外在症状。尤其当团队协作中混合使用 .NET Framework 4.8（Encoding.Default = GBK）与 .NET 7（默认 UTF-8）时，同一行代码在不同环境产出完全不同的字节流。

二、机制层：.NET 文件写入的编码决策树

graph TD A[File.WriteAllText(path, content)] --> B{Target Framework} B -->|NET Framework ≤ 4.8| C[Encoding.Default
（通常为GBK/GB2312）] B -->|NET Core 3.1 / .NET 5+| D[UTF8Encoding(false)
（无BOM的UTF-8）] C --> E[Windows记事本自动识别为ANSI
→ 中文显示正常] D --> F[VS Code/IDEA默认UTF-8
→ 正常；但记事本可能误判为ANSI]

三、根源层：文本文件的本质缺陷与BOM的双重性

编码方式	BOM字节序列	记事本兼容性	POSIX工具兼容性	JSON/XML规范符合度
UTF-8（无BOM）	无	❌ 常误判为ANSI	✅ cat/grep/sed 完全友好	✅ RFC 3629 明确允许
UTF-8（带BOM）	EF BB BF	✅ 记事本强制UTF-8	⚠️ 部分shell脚本解析失败	⚠️ JSON RFC 7159 要求首字符非BOM
GBK	无	✅ 记事本Windows-936模式	❌ Linux终端显示乱码	❌ 非Unicode标准，跨平台失效

四、实践层：全路径编码一致性保障方案

1. 写入端统一声明：File.WriteAllText("test.txt", "你好世界", new UTF8Encoding(true));
2. 读取端严格匹配：var text = File.ReadAllText("test.txt", new UTF8Encoding(true));
3. StreamWriter显式构造：using var sw = new StreamWriter(fs, new UTF8Encoding(false));
4. 配置驱动治理：在 Directory.Build.props 中注入 <DefaultItemExcludes>$(DefaultItemExcludes);*.txt</DefaultItemExcludes> 并配合 EditorConfig 强制 charset=utf-8
5. CI/CD校验：PowerShell 脚本扫描所有 .txt 文件头字节，拒绝提交含 GBK 签名（0xA1A1）或缺失 UTF-8 BOM 的工件

五、架构层：企业级编码治理框架设计

建议构建 TextEncodingPolicy 中心化策略引擎：

• 定义 IContentWriter 接口，封装 WriteAllText、AppendAllText 等操作
• 通过 DI 注入 EncodingProvider，按文件扩展名/目录路径/自定义属性动态选择编码器
• 集成 Roslyn Analyzer，对未指定 Encoding 参数的 File.*Text 调用发出编译警告（CA1305）
• 日志埋点：记录每次文件 I/O 的实际字节长度与前 4 字节签名，用于生产环境编码漂移审计

六、演进层：.NET 9+ 的前瞻应对策略

随着 .NET 9 提议的 UTF-8 Everywhere Initiative 推进，未来将：

• 废弃 Encoding.Default 的隐式使用（标记为 [Obsolete]）
• 新增 File.WriteAllTextUtf8Bom() 和 WriteAllTextUtf8NoBom() 快捷方法
• 在 dotnet new 模板中默认启用 <PropertyGroup><DefaultTextEncoding>utf-8-bom</DefaultTextEncoding></PropertyGroup>
• SDK 内置 dotnet format --encoding=utf8-bom 自动修复存量文件

```