17370845950

Go 1.16+ 废弃 ioutil.ReadDir，改用 os.ReadDir（返回 fs.DirEntry，更轻量）或 filepath.WalkDir（递归遍历，避免冗余 Stat）。需按需调用 d.Info()，优先用 d.IsDir() 或 d.Type() 过滤。

Go 1.16+ 不再推荐用 ioutil.ReadDir

这个函数在 Go 1.16 被标记为 deprecated，实际从 Go 1.19 开始已彻底移除。如果你在新项目里还看到 ioutil.ReadDir，说明代码没升级或依赖了旧文档。它被 os.ReadDir 替代，后者返回 []fs.DirEntry，性能更好、内存更省，且不强制读取全部文件元数据（比如不自动调用 Stat()）。

os.ReadDir 基础遍历：只列名字，不递归

这是最常用场景——列出某目录下所有直接子项（不含子目录内容），且默认不排序（顺序依赖系统底层 readdir 行为）。若需稳定顺序，得手动 sort。

• 返回的是 fs.DirEntry，轻量；要获取完整 os.FileInfo（如修改时间、大小），需显式调用 .Info()
• 不处理符号链接目标，.Name() 返回的是链接本身名，不是它指向的文件名
• 遇到权限错误（如子目录不可读）会直接 panic，需用 os.ReadDir + 错误检查，或改用 filepath.WalkDir

package main

import (
    "fmt"
    "os"
)

func main() {
    entries, err := os.ReadDir(".")
    if err != nil {
        panic(err)
    }
    for _, entry := range entries {
        fmt.Println(entry.Name())
    }
}

递归遍历用 filepath.WalkDir，不是 filepath.Walk

Go 1.16 引入 filepath.WalkDir，替代老的 filepath.Walk。关键区别：WalkDir 传入的是 fs.DirEntry，避免对每个文件都做 Stat()，尤其在大目录中能显著减少系统调用开销。

• 回调函数签名是 func(path string, d fs.DirEntry, err error) error
• 若想跳过某个子目录（比如 node_modules），在回调里 return filepath.SkipDir
• 若某路径 Stat() 失败（如权限不足），err 非 nil，此时 d 可能为 nil，别直接调 d.Info()
• 注意：即使跳过目录，其自身路径仍会进入回调一次（d 有效），只是不继续遍历其子项

package main

import (
    "fmt"
    "io/fs"
    "path/filepath"
)

func main() {
    filepath.WalkDir(".", func(path string, d fs.DirEntry, err error) error {
        if err != nil {
            return nil // 忽略权限错误，继续
        }
        if d.IsDir() && d.Name() == "vendor" {
            return filepath.SkipDir
        }
        fmt.Println(path)
        return nil
    })
}

需要文件大小/时间？谨慎调 d.Info()

fs.DirEntry.Info() 是按需触发系统调用的。如果遍历中只对普通文件需要大小，就别对每个 d 都调 Info()——先用 d.Type() 或 d.IsDir() 过滤，再查。

• d.Type() 可快速判断是否为目录、符号链接、设备文件等，无需 Stat()
• d.Info() 在 Windows 上可能比 Unix 更慢，因 NTFS 元数据组织方式不同
• 若你其实只需要文件名和是否为目录，完全不用 Info()，os.ReadDir 就够了

常见误写：if !d.IsDir() { info, _ := d.Info(); fmt.Println(info.Size()) } ——这里即使 d 是目录，Info() 仍会被调用，浪费。