在C#开发中，向文件写入字符串是非常常见的操作，不同场景下可以选择不同的写入方法，本文会详细介绍几种常用的实现方式。
一、使用File.WriteAllText方法覆盖写入
File.WriteAllText是最简单的写入方法，适合将字符串一次性写入文件，如果文件已存在会直接覆盖原有内容。
方法参数说明：
- 第一个参数是文件路径，支持绝对路径和相对路径
- 第二个参数是要写入的字符串内容
- 第三个参数是可选参数，指定文件编码，默认使用UTF-8编码
using System;
using System.IO;
class Program
{
static void Main()
{
string filePath = "test.txt";
string content = "这是要写入文件的字符串内容";
// 覆盖写入文件，默认UTF-8编码
File.WriteAllText(filePath, content);
// 指定编码写入
// File.WriteAllText(filePath, content, System.Text.Encoding.Default);
Console.WriteLine("写入完成");
}
}
二、使用File.AppendAllText方法追加写入
如果需要保留文件原有内容，在末尾添加新的字符串，可以使用File.AppendAllText方法，该方法不会覆盖原有内容，只会在文件末尾追加新内容。
using System;
using System.IO;
class Program
{
static void Main()
{
string filePath = "test.txt";
string appendContent = "n这是追加的字符串内容";
// 追加写入，默认UTF-8编码
File.AppendAllText(filePath, appendContent);
Console.WriteLine("追加写入完成");
}
}
三、使用File.WriteAllLines方法按行写入
当需要写入多行字符串时，可以将字符串集合作为参数传入File.WriteAllLines方法，每个元素会作为一行写入文件，同样会覆盖原有内容。
using System;
using System.IO;
using System.Collections.Generic;
class Program
{
static void Main()
{
string filePath = "test.txt";
List<string> lines = new List<string>
{
"第一行内容",
"第二行内容",
"第三行内容"
};
// 按行写入，每行对应集合中的一个元素
File.WriteAllLines(filePath, lines);
Console.WriteLine("按行写入完成");
}
}
四、使用StreamWriter类灵活写入
StreamWriter提供了更灵活的写入控制，可以自定义是否追加、编码格式，还支持写入不同类型的数据，适合更复杂的写入场景。
使用StreamWriter时需要注意及时释放资源，建议使用using语句自动释放。
using System;
using System.IO;
class Program
{
static void Main()
{
string filePath = "test.txt";
// 第二个参数true表示追加写入，false表示覆盖写入
using (StreamWriter writer = new StreamWriter(filePath, true, System.Text.Encoding.UTF8))
{
writer.WriteLine("StreamWriter写入的第一行");
writer.Write("StreamWriter写入的不换行内容");
writer.WriteLine("追加的后续内容");
}
Console.WriteLine("StreamWriter写入完成");
}
}
五、不同方法的适用场景对比
| 方法名称 | 适用场景 | 是否覆盖原有内容 |
|---|---|---|
| File.WriteAllText | 单次写入少量字符串，不需要保留原内容 | 是 |
| File.AppendAllText | 追加少量字符串，需要保留原内容 | 否 |
| File.WriteAllLines | 写入多行字符串，不需要保留原内容 | 是 |
| StreamWriter | 复杂写入场景，需要控制编码、追加模式等 | 可通过参数控制 |
六、注意事项
- 写入文件时需要确保程序对目标路径有写入权限，否则会抛出UnauthorizedAccessException异常
- 如果目标路径的目录不存在，File类的方法会自动创建目录，而StreamWriter如果目录不存在会抛出异常
- 写入大量内容时，建议使用StreamWriter并设置合适的缓冲区，提升写入效率
- 涉及文件路径时，可以使用Path类的方法处理路径拼接，避免路径格式错误
C#写入文件File_WriteAllTextStreamWriterFile_AppendAllTextFile_WriteAllLines修改时间：2026-06-28 17:36:31