os.Create是os.OpenFile的快捷封装,适用于新建可读写文件;需精确控制标志位(如追加、只写)时必须用os.OpenFile,避免误清日志;检查文件存在性应使用errors.Is(err, os.ErrNotExist)而非err==os.ErrNotExist;os.RemoveAll可能静默跳过只读文件,删后需os.Stat验证;os.ReadDir比os.ReadDirNames更实用,支持类型判断且避免重复系统调用。

创建文件时 os.Create 和 os.OpenFile 该怎么选
os.Create 是快捷封装,等价于 os.OpenFile(name, os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0666);它适合“从零新建一个可读写文件”,但无法控制更细粒度的标志位(比如只写不截断、追加写、仅创建不覆盖)。真正需要精确控制时,必须用 os.OpenFile。
常见踩坑:想追加日志却用了 os.Create,结果每次运行都清空原文件。正确做法是:
file, err := os.OpenFile("log.txt", os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)
if err != nil {
log.Fatal(err)
}
defer file.Close()
-
os.O_APPEND确保写入总在末尾,无需手动Seek -
os.O_CREATE在文件不存在时自动创建 -
0644是 Unix 权限,Windows 上会被忽略,但建议仍显式传入
判断路径是否存在不能只靠 os.IsNotExist
os.Stat 返回 os.PathError 时,错误类型不一定是“不存在”——也可能是权限不足、路径过长、符号链接断裂等。直接用 err != nil 判断存在性会误判。
正确方式是用 errors.Is(err, os.ErrNotExist)(Go 1.13+)或 os.IsNotExist(err):
立即学习“go语言免费学习笔记(深入)”;
_, err := os.Stat("config.json")
if errors.Is(err, os.ErrNotExist) {
// 文件确实不存在
} else if err != nil {
// 其他错误:比如 permission denied
log.Fatal(err)
}
- 不要用
err == os.ErrNotExist,因为底层错误可能被包装 -
os.IsNotExist内部已处理错误包装,兼容性更好 - 如果只是检查目录是否存在,
os.ReadDir或os.ReadDirNames失败后同样需用该方式判断
os.RemoveAll 删除非空目录时的静默失败风险
os.RemoveAll 会递归删除整个路径,但如果某子项是只读文件(尤其在 Windows 上),它不会报错,而是跳过并继续删其余项,最终返回 nil —— 你以为删干净了,其实残留了东西。
验证是否真删完的最简单方法:删完再 os.Stat 一次,确认返回 os.ErrNotExist:
err := os.RemoveAll("temp_dir")
if err != nil {
log.Fatal(err)
}
// 额外验证
if _, err := os.Stat("temp_dir"); !os.IsNotExist(err) {
log.Fatal("temp_dir still exists or stat failed:", err)
}
- Linux/macOS 下只读文件通常能删掉(只要父目录可写),但 Windows 严格限制
- 若需跨平台稳定删除,考虑先用
os.Chmod(path, 0755)清除只读属性(对文件和目录都要做) -
os.RemoveAll不会删除挂载点(如 Linux 的 mount point),也不会穿透 symlink 目录,这是设计行为,不是 bug
读取目录内容时 os.ReadDir 比 os.ReadDirNames 更实用
os.ReadDirNames 只返回文件名字符串切片,而 os.ReadDir 返回 []fs.DirEntry,每个条目自带 Name()、IsDir()、Type()、Info() 方法,避免重复调用 os.Stat。
例如过滤出所有子目录:
entries, err := os.ReadDir("src")
if err != nil {
log.Fatal(err)
}
for _, entry := range entries {
if entry.IsDir() {
fmt.Println("dir:", entry.Name())
}
}
-
entry.Info()会触发一次系统调用,如不需要详细信息(如大小、修改时间),就别调用它 -
os.ReadDir是 Go 1.16 引入的,比老的os.File.Readdir更轻量、更安全(不依赖文件句柄状态) - 如果只需要文件名且确定不关心类型,
os.ReadDirNames内存开销略小,但实际差异微乎其微
os.Stat 或 os.Remove 的返回值就认定成功,关键路径上补一层验证更稳妥。










