使用 os.openfile 写文件前须明确 flag 含义,常见组合包括覆盖写、追加写和防覆盖创建;目录遍历优先用 filepath.walkdir;文件复制推荐 os.copyfile(go 1.20+)以保留元数据;删除非空目录前需路径校验与白名单防护。

用 os.OpenFile 写文件前必须搞清 flag 参数含义
写文件出错十次里有七次是 os.OpenFile 的 flag 传错了。比如想追加却用了 os.O_WRONLY,结果旧内容被清空;或者想创建新文件却漏了 os.O_CREATE,直接报 no such file or directory。
常见组合要记牢:
-
os.O_CREATE | os.O_WRONLY | os.O_TRUNC:覆盖写,文件不存在就新建 -
os.O_CREATE | os.O_WRONLY | os.O_APPEND:追加写,文件不存在就新建 -
os.O_CREATE | os.O_WRONLY | os.O_EXCL:仅当文件不存在时创建(用于防覆盖)
注意 os.O_APPEND 不等于“线程安全追加”——多个 goroutine 同时写同一个文件仍可能乱序,得自己加锁或用 sync.Mutex。
目录操作别硬写递归,优先用 filepath.WalkDir
手动递归遍历目录容易漏掉权限错误、符号链接循环、空目录跳过等边界情况。Go 1.16+ 的 filepath.WalkDir 内置处理这些,且支持按需中断(返回非 nil error 可停止遍历)。
它比老版 filepath.Walk 更轻量,不强制加载全部 os.DirEntry 信息,适合大目录扫描:
err := filepath.WalkDir("/data", func(path string, d fs.DirEntry, err error) error {
if err != nil {
return err // 权限不足等错误会传进来
}
if d.IsDir() && d.Name() == "temp" {
return filepath.SkipDir // 跳过 temp 目录
}
if !d.IsDir() && strings.HasSuffix(d.Name(), ".log") {
fmt.Println("found:", path)
}
return nil
})
别用 os.ReadDir + 手动递归替代它,除非你明确需要控制遍历顺序或并发深度。
文件复制不能只靠 io.Copy,得处理 os.Link 和元数据
io.Copy 只管字节流,复制后文件的修改时间、权限、属主全丢了,硬链接也会变成普通文件。生产环境用 os.CopyFile(Go 1.20+)最省心,它自动保留 mode 和 modTime。
如果还在用旧版本,得手动补:
- 复制后调用
os.Chmod(dst, info.Mode())和os.Chtimes(dst, info.ModTime(), info.ModTime()) - 想保留硬链接?先用
info.Sys().(*syscall.Stat_t).Nlink判断链接数,再考虑是否用os.Link - 跨文件系统复制时,
os.Link必然失败,得回退到io.Copy流式复制
别在没验证 dst 所在文件系统类型的情况下默认走硬链接逻辑。
删除非空目录用 os.RemoveAll 前先确认路径合法性
os.RemoveAll 是个危险函数:路径末尾带 / 可能误删根目录(如拼接出 //),相对路径没做 filepath.Abs 转换可能删错位置,而它又不提供 dry-run 模式。
安全做法分三步:
- 用
filepath.Clean规范路径,再检查是否以".."开头或包含"//" - 用
os.Stat确认目标存在且是目录(避免误删同名文件) - 对敏感路径(如
/var/log、用户家目录)加白名单校验,而不是依赖用户输入
真正上线的文件管理服务,os.RemoveAll 调用点必须有日志记录原始路径和调用上下文——删错一次,恢复成本远高于预防成本。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











