C#将字符串写入文件 C#最简单地把string保存为文件的方法

来源:这里教程网 时间:2026-02-21 17:41:24 作者:

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
,不必过早优化。

相关推荐