如何使用Golang遍历目录文件_Golang ioutil ReadDir目录遍历示例_技术教程

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