测试文件操作不能直接写磁盘，因真实I/O拖慢测试、污染环境、不可靠且跨平台行为不一致；应使用afero抽象文件系统，测试用MemMapFs，生产用OsFs，并统一用filepath.Join处理路径。
为什么测试文件操作时不能直接写磁盘
因为真实 I/O 会拖慢测试、污染环境、不可靠，且跨平台行为不一致。比如 os.Open 在 Windows 上对路径大小写不敏感，Linux 上敏感；os.RemoveAll 在 CI 环境可能因权限失败；临时目录清理不干净还会让后续测试误读残留文件。
用 afero 替代 os 是最轻量的解法：它把文件系统抽象成接口，测试时换内存实现（afero.NewMemMapFs()），生产时仍走原生 os ——不用改业务逻辑，只换初始化方式。
afero.Fs 接口怎么注入到你的代码里
核心是把依赖从全局 os 拆出来，变成可传入的参数或结构体字段。别在函数里硬写 os.ReadFile，改成接收 fs afero.Fs：
func LoadConfig(fs afero.Fs, path string) ([]byte, error) {
return afero.ReadFile(fs, path)
}
常见错误是只改了函数签名但没改调用链，导致测试时仍走 os。检查所有涉及文件操作的路径，确保每层都透传 fs 参数，或者用结构体封装（如 type Service struct { fs afero.Fs }）。
立即学习“go语言免费学习笔记（深入）”；
注意 afero.ReadFile 和 os.ReadFile 行为基本一致，但前者不会自动创建父目录，WriteFile 同理 —— 如果业务依赖自动建目录，得自己调 fs.MkdirAll。
测试时用 MemMapFs 还是 OsFs
单元测试一律用 afero.NewMemMapFs()：快、隔离、无副作用。它的文件树完全在内存，fs.Create("a/b/c.txt") 不会真的生成路径，fs.Remove 也不影响宿主机。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
集成测试才考虑 afero.NewOsFs()，但仅限验证与真实文件系统交互的边界逻辑（比如符号链接处理、大文件读写性能）。此时必须用 tempdir 隔离，且测试末尾强制清理：
- 用
os.MkdirTemp创建临时根目录 - 把
afero.NewOsFs()包一层：afero.NewBasePathFs(afero.NewOsFs(), tempDir) - 用
defer os.RemoveAll(tempDir)收尾
别省略这步 —— CI 机器上残留测试目录会导致后续任务权限错误或磁盘满。
跨平台路径拼接和分隔符陷阱
afero 本身不处理路径标准化，它忠实地把传入的字符串当路径用。所以 fs.Open("config.yaml") 在 Windows 上等价于 os.Open("config.yaml")，但如果你手动拼接路径："dir" + string(os.PathSeparator) + "file.txt"，就又绑死平台了。
正确做法统一用 path/filepath.Join（运行时决定分隔符）或 path.Join（纯字符串，适合测试路径构造）：
path := filepath.Join("etc", "app", "config.yaml") // 生产用
testPath := path.Join("etc", "app", "config.yaml") // 测试用，无 os 依赖
另外，MemMapFs 对路径大小写敏感（Linux 风格），即使在 Windows 下也如此 —— 别指望它模拟 Windows 的宽容行为。如果业务逻辑依赖大小写不敏感（比如配置文件名匹配），得在代码里显式做 strings.ToLower 处理，而不是依赖底层 FS。
真正麻烦的是符号链接和权限位：MemMapFs 完全不支持 symlink 或 chmod，相关逻辑必须单独 mock 或跳过测试。这点容易被忽略，直到上线后发现链接解析失败。
