如何在Golang中遍历目录文件_使用ioutil ReadDir和filepath Walk-Golang-PHP中文网

如何在Golang中遍历目录文件_使用ioutil ReadDir和filepath Walk

P粉602998670

发布： 2025-12-18 04:29:10

原创

517人浏览过

应根据需求层级选择：只需单层目录列表用os.ReadDir，需递归遍历整个目录树用filepath.WalkDir；旧版Go兼容可选filepath.Walk，但推荐升级迁移。

如何在golang中遍历目录文件_使用ioutil readdir和filepath walk

在 Go 语言中遍历目录有多种方式，ioutil.ReadDir（已弃用，现为 os.ReadDir）适合简单、单层目录读取；而 filepath.Walk（或更现代的 filepath.WalkDir）适用于递归遍历整个目录树。两者用途不同，选错会导致逻辑错误或性能问题。

用 os.ReadDir 遍历单层目录（推荐替代 ioutil.ReadDir）

ioutil.ReadDir 自 Go 1.16 起已被标记为废弃，应改用 os.ReadDir。它返回 []fs.DirEntry，轻量且不预加载文件信息，适合快速列出当前目录下的条目。

只读取指定目录一层，不进入子目录
返回的是 fs.DirEntry，调用 .Name() 获取文件名，.IsDir() 判断是否为目录
如需详细信息（如大小、修改时间），需额外调用 .Info()（会触发一次系统调用）

示例：

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

登录后复制

用 filepath.WalkDir 递归遍历整个目录树（推荐）

filepath.WalkDir 是 Go 1.16 引入的替代 filepath.Walk 的函数，性能更好、更安全（避免重复 stat、支持跳过子目录等）。它按深度优先顺序访问每个文件/目录，并通过回调函数处理每个路径。

Friday AI

国内团队推出的智能AI写作工具

126

查看详情

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

自动递归进入子目录，适合搜索、打包、清理等场景
回调函数签名：func(path string, d fs.DirEntry, err error) error
若在回调中返回 filepath.SkipDir，将跳过当前目录及其所有子项
遇到权限错误等可选择忽略或中断

示例：打印所有 .go 文件路径

err := filepath.WalkDir("./src", func(path string, d fs.DirEntry, err error) error {
    if err != nil {
        return err // 或 log.Printf("skip %s: %v", path, err)
    }
    if !d.IsDir() && strings.HasSuffix(d.Name(), ".go") {
        fmt.Println(path)
    }
    return nil
})
if err != nil {
    log.Fatal(err)
}

登录后复制