c#读取文本文件乱码或开头多字符主要因bom与编码不匹配：应统一使用utf-8无bom标准，读写均显式指定new utf8encoding(false)，禁用bom；避免依赖自动编码推断，并在ci中校验防止带bom文件引入。
读取文本文件时出现乱码或开头多出字符
这基本是BOM（Byte Order Mark）和编码不匹配导致的。C#默认用Encoding.UTF8读取文件时，如果文件带BOM但实际内容是UTF-8无BOM，或反过来——比如用File.ReadAllText(path)没指定编码，它会尝试自动检测BOM，但检测失败就按系统默认编码（如GBK）解码，结果就是乱码或开头出现。
关键点：BOM不是必需的，但一旦存在，就强烈建议显式声明编码；而UTF-8 BOM（0xEF 0xBB 0xBF）在很多工具（如VS、Notepad++）里默认写入，但在跨平台或某些解析器中反而引发问题。
- 统一做法：项目中所有文本文件（.cs、.json、.txt、.config等）应明确约定「UTF-8 无BOM」为标准
- 不要依赖
File.ReadAllText(path)的自动编码推断——它不可靠，尤其对无BOM的UTF-8文件常误判为ANSI - 读取时强制用
Encoding.UTF8（无BOM兼容），写入时用new UTF8Encoding(encoderShouldEmitUTF8Identifier: false)
用File.ReadAllText和File.WriteAllText统一处理编码
这两个方法都支持传入Encoding参数，这是最直接可控的方式。注意：不能只改读取，写入也必须同步，否则下次保存又带BOM，问题复现。
示例：
// ✅ 正确：显式指定UTF-8（无BOM）
string content = File.ReadAllText("config.json", new UTF8Encoding(encoderShouldEmitUTF8Identifier: false));
File.WriteAllText("output.txt", content, new UTF8Encoding(encoderShouldEmitUTF8Identifier: false));
// ❌ 错误：不传Encoding → 可能误判；传Encoding.UTF8 → 默认带BOM
File.WriteAllText("bad.txt", content, Encoding.UTF8); // 这会写入BOM
-
Encoding.UTF8等价于new UTF8Encoding(true)，即默认写BOM；必须显式用new UTF8Encoding(false)禁用 - 若需兼容旧代码，可封装一个静态工具类，把
ReadAllText/WriteAllText全部替换为调用该类的方法，避免漏改 - 对
.cs文件，编译器本身不关心BOM，但编辑器（如VS）可能因BOM影响智能提示或格式化，统一无BOM更稳妥
批量转换现有文件为UTF-8无BOM
项目已有大量带BOM的文件？别手动一个个改。用PowerShell或C#脚本一次性清理更可靠。
PowerShell一行命令（管理员权限非必需，仅需本地执行）：
Get-ChildItem -Recurse -Include "*.json","*.txt","*.config" | ForEach-Object {
$content = Get-Content $_.FullName -Raw -Encoding UTF8
[System.IO.File]::WriteAllText($_.FullName, $content, New-Object System.Text.UTF8Encoding($false))
}
- 务必先备份整个目录，或确认Git已提交当前状态（可回退）
- 注意
Get-Content -Encoding UTF8会自动跳过BOM，所以读出来的是干净字符串；再用UTF8Encoding(false)写入，确保无BOM - 不推荐用Notepad++“转为UTF-8无BOM”手动操作——容易漏文件，且无法纳入CI流程
CI/CD中防止新文件带BOM（如GitHub Actions）
开发人员本地编辑器可能默认保存带BOM，光靠约定不够。可在构建阶段加检查，失败则阻断PR合并。
用C#写个简单校验工具（CheckBom.cs），编译后在CI中运行：
var files = Directory.GetFiles(".", "*.json", SearchOption.AllDirectories);
foreach (var file in files) {
var bytes = File.ReadAllBytes(file);
if (bytes.Length >= 3 && bytes[0] == 0xEF && bytes[1] == 0xBB && bytes[2] == 0xBF) {
Console.WriteLine($"BOM detected: {file}");
Environment.Exit(1);
}
}
- 把这个检查加入
.github/workflows/build.yml的build步骤之前 - 配合EditorConfig（
root = true\n[*.{json,txt,config}]\ncharset = utf-8）能从源头减少带BOM保存，但EditorConfig不强制禁BOM，仍需校验兜底 - 真正难控的是第三方生成的文件（如Swagger导出JSON），这类需单独处理逻辑，不能依赖统一策略
Encoding.UTF8就以为安全了，其实它默认带BOM；还有就是认为“只要读得出来就行”，却没意识到下次保存又悄悄写回BOM，形成死循环。 
