测试文件读写应优先用内存模拟(如bytes.Buffer、bytes.NewReader)验证逻辑,必要时用os.CreateTemp创建临时文件端到端测试,并覆盖错误场景、平台差异及编码细节。

测试文件读写操作的关键是避免依赖真实文件系统,用内存模拟或临时目录隔离副作用,同时覆盖正常路径和错误场景。
使用 bytes.Buffer 或 io.NopCloser 模拟读写流
对函数接口设计为接收 io.Reader 和 io.Writer 的情况,直接传入内存缓冲区即可验证逻辑,无需触碰磁盘。
- 写入测试:创建
bytes.Buffer,调用待测写函数,再检查buf.String()是否符合预期内容 - 读取测试:用
bytes.NewReader([]byte{"hello\nworld"})构造输入,传给读函数,验证解析结果(如结构体字段、切片长度等) - 若函数强制要求
*os.File,可先重构为接受接口;若不可改,再考虑临时文件方案
用 os.CreateTemp 创建临时文件做端到端验证
当必须测试真实文件行为(如权限、原子写、换行符处理、大文件分块)时,用临时目录确保测试干净、可并发、自动清理。
- 调用
os.CreateTemp("", "test-*.txt")获取唯一路径,写入后立即关闭 - 用
os.ReadFile或重新打开读取,比对内容是否一致 - 测试结束后调用
os.Remove删除文件;更稳妥的做法是用defer os.RemoveAll(tempDir)清理整个临时目录 - 注意 Windows 下文件删除可能延迟,避免在同一个测试中重复使用同名路径
主动注入错误来验证容错逻辑
真实 I/O 常因磁盘满、权限不足、路径不存在而失败。不能只测“成功”,要让代码暴露在可控的错误中。
立即学习“go语言免费学习笔记(深入)”;
- 对写操作,把路径设为只读目录(如
/tmp/readonly/xxx),或用filepath.Join(os.TempDir(), "no-such-dir", "file.txt")触发os.IsNotExist - 对读操作,传入空路径、已删除的文件路径,检查是否返回预期错误类型(如
os.IsNotExist(err)) - 可借助
github.com/rogpeppe/go-internal/testscript或自定义包装器,在特定调用中返回伪造错误,但多数场景直接构造异常路径更简单可靠
注意平台差异与编码细节
Windows 换行符(\r\n)、文件路径分隔符(\ vs /)、大小写敏感性都可能影响测试结果。
- 生成测试数据时统一用
\n,读取后用strings.TrimSpace或正则清理换行,避免平台断言失败 - 路径拼接始终用
filepath.Join("dir", "file.txt"),而非字符串加法 - 若读写涉及文本编码(如 UTF-8 BOM、GB2312),在测试中显式指定并验证字节序列,不依赖默认行为










