应将 os.ReadFile 等系统调用抽象为接口并注入，避免直接依赖真实文件系统；测试时使用内存实现或 strings.NewReader/bytes.Buffer 替代，仅在必要时沙盒化调用并严格清理临时目录。
os.ReadFile 这类系统调用不能直接测，必须剥离。否则测试会变慢、不可重复、污染磁盘，CI 环境还可能因权限失败。
把 os.ReadFile 等函数抽成接口再注入
硬编码调用 os.ReadFile 或 os.Open 的函数没法可靠测试——它依赖真实文件系统。正确做法是定义接口，让业务逻辑只依赖抽象行为：
- 定义
type FileReader interface { ReadFile(path string) ([]byte, error) } - 生产代码里传入
osutil.FileReader（包装os.ReadFile） - 测试时传入内存实现，比如返回预设字节切片的结构体
- 如果函数还用了
os.Stat、os.WriteFile，也得一并抽象进同一接口或拆成多个小接口
用 strings.NewReader 和 bytes.Buffer 替代真实 I/O
多数场景根本不需要碰磁盘：只要验证数据流转逻辑是否正确。
- 读取类函数若接收
io.Reader，测试时传strings.NewReader("mock content") - 写入类函数若接收
io.Writer，测试时传&bytes.Buffer{}，之后检查buf.String() - 需要多次读或
Seek？先用io.ReadAll(r)转成[]byte再处理，避免依赖底层句柄 - 别在 mock 里模拟
os.File的全部行为——复杂且易错；只提供测试所需最小契约
真要走系统调用时，必须沙盒化 + 严格清理
仅当绕不开真实文件系统时才这么做，比如验证 filepath.Join 拼接路径、测试 os.Chmod 权限、或多文件协同逻辑。
- 用
os.MkdirTemp("", "test-*")创建唯一临时目录，别用/tmp/test这种固定路径 -
defer os.RemoveAll(tmpdir)必须放在测试函数最开头，确保 panic 时也能清理 - 所有路径都用
filepath.Join(tmpdir, "config.json")拼接，禁止字符串拼接（跨平台不安全） - 想测错误分支（如权限拒绝）？直接在 mock 里返回
os.ErrPermission，别真去改 chmod
最容易被忽略的点：一处硬编码就全盘失效
哪怕只有一行漏掉抽象的 os.ReadFile，整个测试就会悄悄跑在真实磁盘上——你根本不会立刻发现。
立即学习“go语言免费学习笔记（深入）”；
- 重构时得逐行扫业务函数，把每个
os.开头的调用点都拎出来做成参数或接口方法 - grep -r 'os\.ReadFile\|os\.Open\|os\.WriteFile' ./ 可快速定位残留点
- 接口方法命名别图省事叫
Do或Run，而要用语义明确的名，比如ReadConfig、SaveLog
