Golangioutil读取目录文件方法

本文详解了Go 1.16+中读取目录文件列表的现代最佳实践，明确指出已弃用的`io/ioutil.ReadDir`不仅性能低下、功能受限，还会在新版Go中触发警告甚至被移除；推荐全面转向轻量高效的`os.ReadDir`（返回`fs.DirEntry`，按需调用`Info()`获取元数据）和递归遍历首选`filepath.WalkDir`，兼顾性能、安全与可控性，助你写出更符合Go语言演进趋势、更健壮可维护的文件系统操作代码。

在 Go 1.16+ 中，io/ioutil 已被弃用（deprecated），其功能已迁移至 os 和 io/fs 包。因此，**不推荐再使用 io/ioutil.ReadDir 或 io/ioutil.ReadDir 的旧方式获取目录文件列表和文件信息**。下面介绍现代、标准、安全的替代方法。

使用 os.ReadDir 获取目录文件名与基础信息

os.ReadDir 返回 []fs.DirEntry，轻量高效，不加载完整文件信息（如大小、修改时间需显式调用 Info()）：

• 适合只需文件名、是否为目录等快速判断的场景
• 比 os.ReadDir（注意：不是 io/ioutil.ReadDir）更省内存
• 返回的 DirEntry 支持 Name()、IsDir()、Type() 等方法

示例：

entries, err := os.ReadDir("./mydir")
if err != nil {
    log.Fatal(err)
}
for _, entry := range entries {
    fmt.Printf("Name: %s, IsDir: %t\n", entry.Name(), entry.IsDir())
}

使用 os.ReadDir + Info() 获取完整文件信息

若需文件大小、修改时间、权限等详细信息，对每个 DirEntry 调用 Info()：

• entry.Info() 返回 os.FileInfo，包含 Size()、ModTime()、Mode() 等
• 注意：每次调用 Info() 会触发一次系统调用，批量处理时有一定开销
• 适用于需要元数据但目录项不多（如配置目录、日志目录）的场景

示例：

entries, err := os.ReadDir("./mydir")
if err != nil {
    log.Fatal(err)
}
for _, entry := range entries {
    info, err := entry.Info()
    if err != nil {
        log.Printf("skip %s: %v", entry.Name(), err)
        continue
    }
    fmt.Printf("%s | size: %d | mod: %s | mode: %s\n",
        info.Name(), info.Size(), info.ModTime().Format("2006-01-02"), info.Mode())
}

使用 filepath.WalkDir 遍历嵌套目录（含子目录）

当需要递归读取整个目录树（包括子目录）时，filepath.WalkDir 是首选：

• 支持深度优先遍历，自动处理符号链接（可配置跳过）
• 回调函数接收 fs.DirEntry，同样可调用 Info() 获取详情
• 可通过返回非 nil error 控制遍历行为（如跳过某子目录）

示例（仅打印所有普通文件路径）：

err := filepath.WalkDir("./mydir", func(path string, d fs.DirEntry, err error) error {
    if err != nil {
        return err
    }
    if !d.IsDir() {
        fmt.Println("File:", path)
    }
    return nil
})
if err != nil {
    log.Fatal(err)
}

避免踩坑：关于 io/ioutil.ReadDir 的兼容说明

虽然 io/ioutil.ReadDir 在 Go 1.15 及更早版本中可用，但它：

• 返回 []os.FileInfo，内部强制调用 Info()，性能不如 os.ReadDir
• Go 1.16+ 编译会报 warning，未来版本将移除
• 无法区分符号链接与真实目录（IsDir() 对 symlink 可能返回 false）
• 不支持自定义遍历控制（如跳过某些路径）

如需临时兼容老代码，建议直接替换为 os.ReadDir + 显式 Info() 调用，逻辑更清晰、可控性更强。

好了，本文到此结束，带大家了解了《Golangioutil读取目录文件方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！