C# 中将 Stream 高效保存到文件的最佳实践

最优雅的方法：使用 CopyTo 系列

在处理流（Stream）时，将数据从内存流或网络流保存到磁盘文件，最简洁且高效的方案是利用 .NET 内置的 CopyTo 和 CopyToAsync 方法。这两种方式底层已做过深度优化，能够平衡 CPU 占用与 I/O 效率。

同步保存：CopyTo

适用于大多数场景，代码简洁直观。需要注意的是，如果传入的 inputStream 游标（Position）不是从开头开始，应先重置位置。

using (var fileStream = File.Create("C:\\lindexi\\File.txt"))
{
    // 确保从头读取，若已知是完整新流可省略此步
    inputStream.Seek(0, SeekOrigin.Begin);
    inputStream.CopyTo(fileStream);
}

异步保存：CopyToAsync

在高并发或需要提升整体应用响应速度的场景中，推荐使用异步方法。虽然单次操作耗时可能略微增加，但因为它将大部分 I/O 工作交给了操作系统，CPU 可以在此期间处理其他任务，从而显著提升总体性能。

using (var fileStream = File.Create("C:\\lindexi\\File.txt"))
{
    await inputStream.CopyToAsync(fileStream);
}

资源管理注意事项

当 inputStream 是由外部传入的参数时，通常不建议在当前方法内部对其进行释放（Dispose）。例如：

// ❌ 不推荐：意外关闭了外部管理的流
using (var fileStream = File.Create(...))
{
    using (inputStream) // 这里的 close 可能会影响调用方的预期行为
    {
        inputStream.CopyTo(fileStream);
    }
}

除非你完全控制该流的生命周期，否则应遵循“谁创建谁释放”的原则，由调用方负责关闭传入的流。

替代方案：自定义缓冲区控制

如果你需要更精细地控制内存分配（例如针对超大数据块调整缓冲大小），可以自己编写循环进行复制。这种方法比直接调用 Read/Write 更清晰，但也多出了一次数组拷贝的成本。

public static void CopyStream(Stream input, Stream output)
{
    byte[] buffer = new byte[1024]; // 可根据需求调整大小
    int len;
    while ((len = input.Read(buffer, 0, buffer.Length)) > 0)
    {
        output.Write(buffer, 0, len);
    }
}

// 使用示例
using (Stream file = File.Create("C:\\lindexi\\File.txt"))
{
    CopyStream(input, file);
}

不推荐的做法

以下方法虽然在某些特定条件下（如快速原型开发）看起来方便，但在生产环境中存在严重的性能瓶颈或资源浪费风险。

频繁内存复制法

先复制到 MemoryStream，再转换为字节数组写入文件。这会导致两次完整的内存拷贝，对于大文件极易引发 OutOfMemoryException。

using (var stream = new MemoryStream())
{
    input.CopyTo(stream);
    File.WriteAllBytes(file, stream.ToArray()); // ❌ 产生双倍内存开销
}

一次性申请大块内存法

假设流长度固定并申请对应大小的数组。这在流长度未知或极大时非常危险，且并未利用系统的零拷贝机制。

public void SaveStreamToFile(string fileFullPath, Stream stream)
{
    if (stream.Length == 0) return;
    
    // 警告：如果流非常大，此处会瞬间耗尽内存
    using (FileStream fileStream = System.IO.File.Create(fileFullPath, (int)stream.Length))
    {
        byte[] bytesInStream = new byte[stream.Length];
        stream.Read(bytesInStream, 0, (int)bytesInStream.Length);
        fileStream.Write(bytesInStream, 0, bytesInStream.Length);
    }
}

逐字节写入法

每次只读写一个字节。这是极端的反模式，由于频繁的函数调用和 I/O 上下文切换，速度极慢，绝对禁止在生产环境使用。

public void Write(Stream from, Stream to)
{
    int a;
    while ((a = from.ReadByte()) != -1)
    {
        to.WriteByte((byte)a); // ❌ 性能灾难
    }
}

以上就是C#将Stream保存到文件的方法的详细对比，更多关于高性能C#编码的资料请关注本站其它相关文章！