17370845950

Go 1.16+ 中应使用 os.ReadDir 替代已弃用的 io/ioutil.ReadDir；os.ReadDir 返回轻量级 fs.DirEntry，支持 Name()、IsDir() 等方法，需 Info() 获取完整文件信息；嵌套目录遍历推荐 filepath.WalkDir。

在 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() 调用，逻辑更清晰、可控性更强。