c#如何使用StreamReader读取文件？StreamReader用法全面总结

在C#中处理文本文件时，StreamReader是最常用的工具类之一。它位于System.IO命名空间下，专门用于以特定编码从字节流中读取字符。相比直接使用File.ReadAllText这类静态方法，StreamReader提供了更细粒度的控制能力，比如逐行读取、指定缓冲区大小、控制字符编码等，特别适合处理大文件或者需要边读边处理的场景。本文将从基础用法开始，逐步深入到编码处理、资源释放和性能优化等内容。

一、StreamReader的基本用法

StreamReader的构造函数有多种重载形式，最简单的方式是直接传入文件路径。下面的例子演示了最基础的读取操作：

using System;
using System.IO;

class Program
{
    static void Main()
    {
        // 使用using语句确保读取完成后自动关闭文件流
        using (StreamReader reader = new StreamReader(@"C:\temp\test.txt"))
        {
            string content = reader.ReadToEnd();
            Console.WriteLine(content);
        }
    }
}

这段代码中的ReadToEnd方法会把文件内容从当前位置到末尾一次性全部读出来，返回一个字符串。它适合读取体量不大的文件，比如配置文件、模板文件等。但如果文件有几个GB，一次性读入内存就会带来严重问题，轻则占用大量内存，重则直接抛出OutOfMemoryException异常。

需要特别注意的是，StreamReader打开文件后独占了文件句柄。如果不调用Close或者Dispose，文件会被一直占用，其他程序就无法写入或删除这个文件。所以上面的代码使用了using语句块，当代码块执行完毕时，无论是否发生异常，都会自动释放资源。这是使用StreamReader时必须养成的习惯。

C# 8.0之后还可以使用更简洁的using声明语法，不需要大括号，当变量离开作用域时自动释放：

using var reader = new StreamReader(@"C:\temp\test.txt");
string line;
while ((line = reader.ReadLine()) != null)
{
    Console.WriteLine(line);
}

二、逐行读取：处理大文件的标准姿势

ReadLine方法每次读取一行内容，返回字符串；如果已经读到文件末尾，则返回null。这是处理日志文件、CSV文件等按行组织的数据时最推荐的方式，因为内存中任何时刻只保留一行数据，文件再大也不会撑爆内存。

using System;
using System.IO;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var lines = new List<string>();
        using (StreamReader reader = new StreamReader(@"C:\temp\log.txt"))
        {
            string line;
            while ((line = reader.ReadLine()) != null)
            {
                lines.Add(line);
            }
        }
        Console.WriteLine($"共读取 {lines.Count} 行");
    }
}

while循环的条件写法(line = reader.ReadLine()) != null是C#里的经典模式，先赋值再判断是否为null，一行代码完成读取和判断两个动作。需要注意，ReadLine返回的字符串不包含换行符本身，空行会被读成空字符串而不是null，只有到达文件末尾才返回null，这一点在判断时不要搞混。

如果只是想把文件读成字符串数组，也可以用File.ReadAllLines一步到位。但它的底层实现同样是把所有行加载进内存，本质区别不大，而手动使用ReadLine的好处在于可以在读取过程中随时中断、过滤或做流式处理，灵活性更高。比如读取超大日志文件时只提取包含错误关键字的行：

using (StreamReader reader = new StreamReader(@"C:\temp\app.log"))
{
    string line;
    while ((line = reader.ReadLine()) != null)
    {
        if (line.Contains("ERROR"))
        {
            Console.WriteLine(line);
        }
    }
}

三、编码问题：中文乱码的根源与解决

很多中文乱码问题的根源都出在编码上。StreamReader默认使用UTF-8编码读取，如果文件实际是GBK（也就是GB2312的扩展）编码保存的，读出来的中文就会变成一堆问号或者火星文。解决办法是在构造时明确指定编码：

using System.IO;
using System.Text;

// 指定编码为GBK，解决中文乱码
using (StreamReader reader = new StreamReader(@"C:\temp\中文文档.txt", Encoding.GetEncoding("GBK")))
{
    string content = reader.ReadToEnd();
}

这里有一个坑需要注意：在.NET Core 3.0及以后的版本中，Encoding.GetEncoding("GBK")默认会抛出异常，因为默认安装里不再包含这些区域编码。需要先注册代码页提供程序，在项目里通过NuGet安装System.Text.Encoding.CodePages包，然后在程序启动时执行：

using System.Text;

// 注册代码页编码提供程序，只需执行一次
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

// 注册之后才能正常获取GBK编码
var gbk = Encoding.GetEncoding("GBK");

另一个实用技巧是让StreamReader自动检测文件的字节顺序标记，也就是BOM。构造函数中传入detectEncodingFromByteOrderMarks: true参数（不传时默认也是true），如果文件开头带有BOM，StreamReader会自动识别并使用对应编码。对于不确定来源的文件，还可以在读取几行后通过reader.CurrentEncoding属性查看实际采用的编码。

四、按字符与按块读取：更底层的控制

除了按行和按全文读取，StreamReader还支持按字符和按块读取。Read方法每次读取一个字符，返回int类型的字符编码值，读到末尾返回-1：Read(char[] buffer, int index, int count)则把字符读入指定的字符数组，这是分块读取大文件的核心方法。

using (StreamReader reader = new StreamReader(@"C:\temp\big.txt"))
{
    char[] buffer = new char[4096]; // 每次读取4KB字符
    int charCount;
    while ((charCount = reader.Read(buffer, 0, buffer.Length)) > 0)
    {
        // 对buffer中前charCount个字符进行处理
        string chunk = new string(buffer, 0, charCount);
        ProcessChunk(chunk);
    }
}

static void ProcessChunk(string chunk)
{
    // 这里可以做流式处理，例如统计字符数或写入其他流
}

分块读取的好处是内存占用恒定可控，无论文件多大，内存里始终只有4KB左右的数据。这个模式在需要把文件内容转发到网络流、压缩流或者做哈希计算时特别有用。块大小的选择有一定讲究，太小会导致IO调用次数过多影响性能，太大则浪费内存，一般4096到65536之间的2的幂次比较合适。

此外还有ReadBlock方法，它和带参数的Read功能类似，区别在于ReadBlock会尽可能读满指定的字符数，除非到达文件末尾才提前返回，相当于阻塞式读取。对于需要精确控制每次处理数据量的场景，ReadBlock语义更明确。

五、性能建议与常见误区

在使用StreamReader时有几个容易踩坑的地方需要提醒。第一，不要在循环里反复创建StreamReader去读同一个文件，每次构造都会重新打开文件句柄，开销很大，应该在循环外打开一次。第二，StreamReader本身自带内部缓冲区，默认大小是1024字节，可以通过构造函数调整，比如new StreamReader(path, encoding, true, 81920)就能把缓冲区设为80KB，对大文件顺序读取有明显提速效果。

第三点要理解流的特性。StreamReader可以包装在FileStream之上，这样可以先设置好文件流的参数再交给StreamReader处理，例如禁止缓存提示FileStreamOptions，或者从文件中间的某个位置开始读取：

using (FileStream fs = new FileStream(@"C:\temp\data.txt", FileMode.Open, FileAccess.Read))
{
    fs.Seek(1024, SeekOrigin.Begin); // 跳过文件头1024字节
    using (StreamReader reader = new StreamReader(fs))
    {
        string rest = reader.ReadToEnd();
    }
}

最后做个简单总结：小文件直接ReadToEnd省事；按行数据用ReadLine逐行处理；超大文件用字符数组分块读取；遇到中文乱码先检查编码并在构造函数中明确指定。只要掌握这几条原则，配合using语句保证资源释放，StreamReader的各种文件读取需求基本都能从容应对。

StreamReaderC#读取文件文件流修改时间：2026-09-03 14:45:26