17370845950

ioutil.ReadDir 已被弃用，因其功能移至 os.ReadDir；后者返回轻量级 fs.DirEntry 切片，仅含名称和类型标志，按需调用 .Info() 才加载完整元数据，提升性能。

为什么 ioutil.ReadDir 已被弃用，但你还可能看到它

Go 1.16 起，ioutil.ReadDir 已正式标记为 deprecated，它的功能已移入 os.ReadDir。如果你在旧项目、教程或报错信息里看到它，不是你写错了，而是代码没升级。继续用它不会立即报错，但会收到编译警告："ioutil.ReadDir is deprecated: Use os.ReadDir instead"。核心原因是 os.ReadDir 返回 []fs.DirEntry，比 ioutil.ReadDir 返回的 []os.FileInfo 更轻量——它默认不加载完整文件元数据（比如大小、修改时间），只读取名称和类型标志，按需调用 .Info() 才触发系统调用。

用 os.ReadDir 正确遍历目录（Go 1.16+）

这是当前标准做法。注意它返回的是 fs.DirEntry 切片，不是 os.FileInfo，所以不能直接访问 .Size() 或 .ModTime()。

package main

import (
    "fmt"
    "log"
    "os"
)

func main() {
    entries, err := os.ReadDir(".")
    if err != nil {
        log.Fatal(err)
    }

    for _, entry := range entries {
        // entry.Name() 是文件/目录名（不含路径）
        // entry.IsDir() 判断是否为目录
        fmt.Printf("Name: %s, IsDir: %t\n", entry.Name(), entry.IsDir())

        // 如果需要详细信息（如大小、时间），显式调用 Info()
        // 注意：这会触发一次额外的系统调用
        if !entry.IsDir() {
            info, err := entry.Info()
            if err == nil {
                fmt.Printf("  Size: %d bytes\n", info.Size())
            }
        }
    }
}

• 必须用 entry.Name() 获取名称，不能用 entry.Name（字段不存在）
• entry.IsDir() 是廉价判断，推荐优先用它过滤目录，避免无谓的 .Info() 调用
• 如果只需要文件名列表，完全不用 .Info()，性能更好

如果必须兼容旧版 Go（

只能回退到 ioutil.ReadDir，但要注意它返回的是 []os.FileInfo，每个元素都已加载完整元数据，开销更大。

package main

import (
    "fmt"
    "io/ioutil" // Go < 1.16 才可用；1.16+ 需 import "io/ioutil" 并忽略警告
    "log"
)

func main() {
    infos, err := ioutil.ReadDir(".")
    if err != nil {
        log.Fatal(err)
    }

    for _, info := range infos {
        fmt.Printf("Name: %s, IsDir: %t, Size: %d\n",
            info.Name(), info.IsDir(), info.Size())
    }
}

• Go 1.16+ 仍可编译，但会警告；Go 1.22+ 可能彻底移除该包（实际尚未移除，但风险存在）
• 所有 os.FileInfo 字段（Size()、ModTime()、Mode()）可直接用，无需额外调用
• 若目录下有大量小文件，ioutil.ReadDir 的内存和系统调用开销明显高于 os.ReadDir

常见错误：把 os.ReadDir 当成递归遍历工具

os.ReadDir 只做单层遍历，它不递归。很多人误以为“读取目录”就等于“列出所有子目录里的文件”，结果只看到第一层内容就停了。递归需要自己实现或改用 filepath.WalkDir（推荐）。

立即学习“go语言免费学习笔记（深入）”；

• 错误写法：os.ReadDir("path/to/dir") → 只得到 path/to/dir 下的直接子项
• 正确递归方案：用 filepath.WalkDir，它接收回调函数，自动处理嵌套层级
• filepath.WalkDir 的回调参数是 fs.DirEntry，行为与 os.ReadDir 一致，同样支持按需 .Info()

真正要遍历整个目录树时，别硬套 os.ReadDir 加递归逻辑，filepath.WalkDir 是更健壮、更少出错的选择。