用 File.WriteAllText
一行搞定
最简单、最直接的方法就是调用
File.WriteAllText。它自动处理编码(默认 UTF-8 无 BOM)、创建文件、写入内容、关闭流,全程无需手动管理
StreamWriter或
FileStream。
常见错误是误用
File.AppendAllText——它会在文件末尾追加,而不是覆盖写入;如果目标是“保存当前字符串为文件全部内容”,必须用
WriteAllText。
File.WriteAllText("path.txt", "hello world"); —— 默认 UTF-8 编码(无 BOM)
File.WriteAllText("path.txt", "你好", Encoding.UTF8); —— 显式指定 UTF-8(效果同上)
File.WriteAllText("path.txt", "你好", Encoding.Default); —— 使用系统本地编码(如 GBK),跨平台易出乱码,不推荐
路径不存在时会自动创建目录吗?
不会。
File.WriteAllText只能创建文件,不能创建父目录。如果
"logs/error.txt"中的
logs文件夹不存在,会抛出
DirectoryNotFoundException。
安全写法是先确保目录存在:
Directory.CreateDirectory(Path.GetDirectoryName("logs/error.txt"));
再调用 File.WriteAllText("logs/error.txt", content);
注意:
Directory.CreateDirectory对已存在的目录是安全的,不会报错或覆盖。
需要带 BOM 的 UTF-8 怎么办?
默认的
File.WriteAllText输出的是 UTF-8 无 BOM。某些旧工具(如部分 Windows 记事本版本、PowerShell
Get-Content)可能无法正确识别无 BOM 的 UTF-8,导致中文显示为乱码。
解决方法:显式传入
new UTF8Encoding(true)(
true表示带 BOM):
File.WriteAllText("data.json", json, new UTF8Encoding(true));
但要注意:BOM 是三个字节(
EF BB BF),对纯机器读取(如 JSON 解析、API 接收)一般无影响;极少数严格校验首字符的解析器可能报错,此时需确认接收方要求。
大字符串(几百 MB)还能用这个方法吗?
不建议。
File.WriteAllText会把整个字符串一次性加载进内存,再整体写入磁盘。若字符串过大,容易触发
OutOfMemoryException,尤其在 32 位进程或内存受限环境。
替代方案(仅当确认字符串极大时才需考虑):
改用File.WriteAllLines+ 分块生成(适合按行组织的内容) 手动用
StreamWriter流式写入:
using var sw = new StreamWriter("out.txt", false, Encoding.UTF8); sw.Write(content);
绝大多数业务场景(日志、配置、小量数据导出)中,“几百 KB 到几 MB”的字符串完全适用
WriteAllText,不必过早优化。
