Golangos包目录操作详解

一分耕耘，一分收获！既然都打开这篇《Golang os包文件目录操作教程》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新Golang相关的内容，希望对大家都有所帮助！

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)：

_, 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 内存开销略小，但实际差异微乎其微

今天关于《Golangos包目录操作详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！