go不用“工具类”封装，因其不支持类和静态方法，而fileutil.readfile等包级函数集合无法携带状态、难测试、违反io.reader等接口哲学；正确方式是用结构体+选项模式封装可配置、可替换依赖（如fs.fs）的文件操作上下文。
Go 语言没有“工具类”概念，也不该封装成静态方法集合；真正的通用文件操作封装，是围绕 os.File 和 io 接口做行为抽象 + 包级组合，而不是堆砌函数。
为什么不用“工具类”风格的封装？
Go 不支持类和静态方法，所谓“文件工具类”常见写法如 FileUtil.ReadFile() 或 FileUtils.Copy()，本质是包级函数集合。这种封装有三个硬伤：
- 无法携带状态（比如默认编码、重试策略、日志器），每次调用都得重复传参
- 难以 mock 测试——所有函数直接依赖
os和ioutil（已弃用），没法注入模拟实现 - 违反 Go 的接口哲学：不是“它能做什么”，而是“它实现了什么能力”，比如
io.Reader、io.WriteCloser才是真正可组合的契约
正确的封装方式：用结构体 + 接口 + 选项模式
把文件操作能力收束到一个结构体里，让它持有可配置项和依赖（如 fs.FS、io.Writer、*log.Logger），并通过方法暴露行为。例如：
type FileOp struct {
fs fs.FS // 可替换为 embed.FS、os.DirFS 或 mock.FS
log *log.Logger // 可选，用于调试/审计
perm fs.FileMode // 默认创建权限
}
func NewFileOp(opts ...FileOpOption) *FileOp {
op := &FileOp{
fs: os.DirFS("."),
perm: 0644,
}
for _, opt := range opts {
opt(op)
}
return op
}
type FileOpOption func(*FileOp)
func WithFS(f fs.FS) FileOpOption {
return func(o *FileOp) { o.fs = f }
}
func WithLogger(l *log.Logger) FileOpOption {
return func(o *FileOp) { o.log = l }
}
这样封装后，FileOp 就成了可复用、可测试、可配置的“文件操作上下文”。
关键方法设计：别封装 os 的全部 API，只暴露高频安全操作
用户真正需要的不是 os.Open、os.Stat 的镜像，而是带默认错误处理、路径安全检查、自动创建父目录等能力的操作。例如：
-
op.ReadText(path string) (string, error)—— 自动处理 UTF-8 BOM、换行归一化 -
op.WriteJSON(path string, v interface{}) error—— 带os.O_CREATE | os.O_TRUNC、缩进、权限控制 -
op.Copy(src, dst string) error—— 自动判断是否跨文件系统，用io.Copy+fs.CopyFile（Go 1.21+）或 fallback 到流式复制 -
op.EnsureDir(path string) error—— 等价于os.MkdirAll，但可加日志、跳过已存在、校验父目录可写
所有方法内部应避免裸调 os，优先走 fs.FS 接口，保证可测试性；错误返回统一包装（如用 fmt.Errorf("read %q: %w", path, err)），便于上层链路追踪。
容易踩的坑：路径拼接、权限、临时文件、并发安全
封装时这几个点最容易出问题：
-
path参数必须用filepath.Join拼接，禁止字符串+—— Windows/Linux 路径分隔符不一致 -
os.Create或os.OpenFile的perm参数在 umask 下可能失效，建议显式调用os.Chmod补全 - 写临时文件不要用
os.TempDir()直接拼路径，改用os.CreateTemp("", "*.tmp")，并确保defer os.Remove成对出现 -
FileOp实例本身是无状态的，但若缓存了fs.FS或 logger，就天然支持并发；切勿在结构体里存*os.File或sync.Mutex，那是使用者的责任
最常被忽略的一点：封装库不该假设用户一定用本地磁盘。只要结构体字段是 fs.FS 类型，就能无缝切换到 embed.FS（编译时嵌入）、memfs.New（内存文件系统）、甚至自定义 HTTP FS。这才是 Go 封装的真正价值——不是功能多，而是边界清、替换易、不绑架调用方。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
