FileStream构造必须显式指定FileMode和FileAccess,漏掉FileShare易致并发异常;大文件须分块读写(推荐8KB–64KB缓冲区);异步需启用isAsync:true;操作Position前须检查CanSeek。

FileStream 构造时必须指定 FileMode 和 FileAccess
很多人一上来就写 new FileStream("a.txt"),直接抛 ArgumentException:「The parameters are not valid」。因为 FileStream 不像 File.OpenRead() 那样有默认行为,它要求你明确告诉它「想怎么打开这个文件」。
常见组合:
-
FileMode.OpenOrCreate+FileAccess.ReadWrite:读写都可能,文件不存在就新建 -
FileMode.Open+FileAccess.Read:只读,文件必须存在,否则抛FileNotFoundException -
FileMode.Create+FileAccess.Write:清空重写,慎用——会丢数据
漏掉 FileShare 也容易踩坑:比如另一个进程正在读这个文件,而你用默认的 FileShare.None 去打开,就会卡住或报 IOException。需要并发访问时,显式传 FileShare.Read 或 FileShare.ReadWrite。
大文件分块读写必须控制 buffer 大小,别用 ReadAllBytes()
File.ReadAllBytes() 看着方便,但遇到 500MB 的日志文件,直接把整个内容加载进内存,GC 压力陡增,还可能触发 OutOfMemoryException。分块读写的本质是「流式搬运」:每次只处理一块,用完就丢。
实操建议:
- 缓冲区大小选
8192(8KB)或65536(64KB)较稳妥;太小(如 1KB)导致系统调用频繁,IO 效率低;太大(如 1MB)对内存不友好,且多数磁盘/SSD 的最佳 IO 单位在 4KB–64KB - 用
stream.Read(buffer, 0, buffer.Length),注意返回值是「实际读到的字节数」,可能小于buffer.Length(尤其是最后一块),必须用这个值来决定写多少 - 别忘了
stream.Flush()(写场景下),尤其在未关闭流前要确保数据落盘;如果用了using,会在Dispose()时自动刷,但手动控制更清晰
示例关键片段:
byte[] buffer = new byte[65536];
int bytesRead;
while ((bytesRead = input.Read(buffer, 0, buffer.Length)) > 0)
{
output.Write(buffer, 0, bytesRead);
}
异步操作要用 ReadAsync/WriteAsync,别在线程池里 Task.Run 包同步方法
有人为了“不阻塞 UI”,把 stream.Read() 套进 Task.Run(() => { ... }),这没真正释放线程——只是把阻塞挪到了线程池线程上,还增加了调度开销。.NET 的 FileStream 在 Windows 上支持真正的异步 IO(I/O Completion Ports),前提是启用 isAsync: true 构造参数。
正确姿势:
- 构造时加
isAsync: true:new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, isAsync: true) - 然后直接用
await stream.ReadAsync(buffer, CancellationToken.None),这才是零线程占用的异步 - 不加
isAsync: true就算用了ReadAsync,底层也是模拟的(同步读+线程池),性能反而更差
注意:.NET Core 2.1+ 默认开启 isAsync(Windows),但 .NET Framework 和跨平台场景仍需显式传参,不能依赖默认。
关闭流前务必检查 CanSeek,别假设所有流都能 Position
写完一个大文件后想回写头部加个校验头?或者读取时想反复跳转?这时候如果流来自网络(NetworkStream)或某些压缩包装器,stream.CanSeek 是 false,直接访问 stream.Position 或调 Seek() 就会崩出 NotSupportedException。
安全做法:
- 操作前先判断:
if (stream.CanSeek) { stream.Position = 0; } - 不要在通用工具方法里硬写
stream.Position = x,除非你 100% 控制输入流类型 - 对不可寻址流,如需重读,只能重新打开文件或缓存已读内容(权衡内存)
这个点特别容易被忽略——本地测试用 FileStream 没问题,一上生产对接管道或加密流就挂。


















