C# 文件流操作方法 C#如何使用FileStream

FileStream构造函数参数必须匹配:FileMode决定文件行为,FileAccess指定操作类型,二者需兼容(如Append仅允许Write),FileShare控制并发访问;using管理是必须的,确保及时释放句柄;Read/Write返回值不可忽略,需循环处理以保证全部数据完成。

FileStream 构造函数参数怎么选

创建 FileStream 最容易出错的地方是构造函数参数组合不匹配。比如用 FileMode.Create 却传了 FileAccess.Read,运行时直接抛 ArgumentException:“The file access requested is not compatible with the access required by the file mode.”

  • FileMode 决定文件存在与否时的行为(如 Create 总是清空重写,OpenOrCreate 存在则打开、不存在则新建)
  • FileAccess 是你打算对流做的操作(Read / Write / ReadWrite),必须和 FileMode 兼容:比如 FileMode.Append 只允许 FileAccess.Write
  • FileShare 控制其他进程能否同时访问该文件;默认 FileShare.None 会独占锁,若另一程序正读这个文件,你的 FileStream 就会阻塞或抛 IOException

用 using 管理 FileStream 是必须的吗

是。不显式调用 Dispose() 或不用 using,文件句柄不会立即释放,可能导致后续操作失败(如“文件正由另一进程使用”)、磁盘空间无法回收、甚至 AppDomain 卸载异常。

常见错误写法:

FileStream fs = new FileStream("log.txt", FileMode.Append, FileAccess.Write);
fs.Write(buffer, 0, buffer.Length);
// 忘了 fs.Close() 或 fs.Dispose()

正确写法:

using (FileStream fs = new FileStream("log.txt", FileMode.Append, FileAccess.Write, FileShare.Read))
{
    fs.Write(buffer, 0, buffer.Length);
} // 自动调用 Dispose,释放句柄并刷新缓冲区

  • 即使发生异常,using 块仍保证 Dispose() 被调用
  • 如果手动管理,必须在 finally 中调用 Dispose(),且要判空
  • FileStreamDispose() 会隐式调用 Flush(),但不保证磁盘落盘(需配合 Flush(true) 强制写入物理设备)

Read/Write 方法返回值为什么不能忽略

FileStream.Read()FileStream.Write() 都返回实际操作的字节数,不是“成功就返回传入长度”。尤其在网络映射盘、加密文件系统或磁盘满时,可能只写入部分数据却无异常抛出。

典型误用:

fs.Write(buffer, 0, buffer.Length); // ❌ 假设全部写完

安全写法:

int totalWritten = 0;
while (totalWritten < buffer.Length)
{
    int written = fs.Write(buffer, totalWritten, buffer.Length - totalWritten);
    if (written == 0) throw new IOException("Write returned 0 bytes — stream may be closed or full.");
    totalWritten += written;
}

  • Read() 同理:返回 0 表示已到流末尾,不是“读完了所有请求字节”
  • 同步 I/O 下,Read() 可能一次只读几字节(尤其小缓冲区 + 大文件)
  • 若需原子性写入,应先写临时文件,再 File.Move() 替换原文件

FileStream 和 File 类方法有什么本质区别

File.OpenRead()File.ReadAllBytes() 这些是封装好的快捷方式,底层仍用 FileStream,但它们隐藏了生命周期控制和缓冲策略细节。

  • File.ReadAllBytes("a.bin") 会一次性把整个文件加载进内存 —— 文件超 100MB 就容易 OOM
  • File.Copy() 默认不保留 NTFS 权限或时间戳,而用 FileStream 手动复制可控制每个字节、加进度回调、做校验
  • 高频小文件写入(如日志)用 FileStream 配合 BufferedStream 更可控;简单读取配置可用 File.ReadAllText()
  • FileStream 支持 Seek() 随机读写,File 类静态方法全是一次性顺序操

真正需要精细控制 I/O 行为、处理大文件、或避免内存暴涨时,绕不开直接用 FileStream。其他情况,优先选 File 类方法更简洁安全。