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