filestream必须用using确保安全释放句柄并检查read/write返回值,否则易锁文件、读乱码或处理错误数据; filemode与fileaccess需严格配对,缓冲区读写须循环判断实际字节数。

FileStream 是 C# 里操作文件最底层、最灵活的字节流工具,不是“怎么用”,而是“必须知道怎么安全地用”——它不自动释放句柄,不处理编码,不跳过空格,写错一个参数就可能锁死文件、读出乱码、或在大文件上卡死。
创建 FileStream 必须配对 FileMode 和 FileAccess
常见错误:只传路径和 FileMode,却没指定 FileAccess,结果默认是 ReadWrite,但你只想读——系统就抛 UnauthorizedAccessException。
-
FileMode.Open+FileAccess.Read:安全读已有文件(文件不存在就崩) -
FileMode.Create+FileAccess.Write:清空重写,不怕文件存在,但会丢数据 -
FileMode.Append+FileAccess.Write:只能写末尾,且不能搭配Read -
FileMode.OpenOrCreate+FileAccess.ReadWrite:适合读写日志类文件,但要自己判断是否首次创建(fs.Length == 0)
using (var fs = new FileStream("data.bin", FileMode.Open, FileAccess.Read))
{
byte[] buf = new byte[4096];
int read = fs.Read(buf, 0, buf.Length); // 注意:返回值是实际读到的字节数,不是 buffer.Length
}读大文件别一次性 LoadAll,要用 while 循环 + Read 返回值判断
直接 fs.Read(buf, 0, buf.Length) 并不保证填满 buf——网络磁盘、权限受限、甚至文件被其他进程截断,都可能导致 read 。忽略返回值,就会把残留旧数据当新内容处理。
-
Read返回0表示已到文件末尾(不是“没读到”,是“真读完了”) - 永远用
while ((n = fs.Read(buf, 0, buf.Length)) > 0),而不是while (fs.Position (后者在异步/网络文件系统下不准) - 缓冲区大小建议设为
4096或8192:太小频繁调用系统 API,太大吃内存又无增益
写文件必须用 using,否则文件锁死、后续程序打不开
FileStream 持有操作系统级文件句柄,不用 using 或手动 Dispose(),句柄不会释放——哪怕方法执行完,文件仍被“占用中”,Windows 资源管理器提示“正在被另一个程序使用”,VS 编译报“无法访问该文件,因为它正由另一进程使用”。
-
using是唯一推荐方式;不用using就必须三连:fs.Flush()→fs.Close()→fs.Dispose() -
Flush()不是可选:尤其写小数据时,内容还在内核缓冲区,Close()会隐式Flush,但显式调更可控 - 别信“GC 会回收”——
FileStream包含SafeFileHandle,是非托管资源,GC 不管它
string text = "Hello, world!";
byte[] bytes = Encoding.UTF8.GetBytes(text);
using (var fs = new FileStream("out.txt", FileMode.Append, FileAccess.Write, FileShare.Read))
{
fs.Write(bytes, 0, bytes.Length); // Append 模式下,自动 seek 到末尾
}随机访问文件?Seek 是唯一可靠方式,但注意 Position 单位是字节
想跳到第 100 行?不行。Seek 只认字节偏移,不认换行符。文本文件里一行多少字节取决于编码(UTF8 中中文占 3 字节,ASCII 英文占 1 字节),所以“跳到第 N 行”必须自己解析,Seek 只能用于二进制结构化文件(如自定义头+数据块)。
-
fs.Seek(1024, SeekOrigin.Begin):从开头跳 1024 字节 -
fs.Seek(-5, SeekOrigin.Current):往回退 5 字节(要求CanSeek == true,Append模式下为false) - 调
Seek前务必检查fs.CanSeek,否则运行时报NotSupportedException -
Position是属性,可读可写,但写入非法位置(如负数)会立刻抛异常
真正容易被忽略的点就两个:一是所有 Read/Write 都必须检查返回值,二是 using 不是语法糖,是保命机制。其他花哨功能,比如异步 ReadAsync、共享模式 FileShare.Delete,都是在踩稳这俩地基之后才值得碰的。









