Golang遍历目录文件技巧

本文详解了Go语言中现代目录遍历的最佳实践：自Go 1.16起，应摒弃已废弃的ioutil.ReadDir，转而优先使用轻量高效的os.ReadDir（适用于单层快速列举，返回fs.DirEntry避免冗余系统调用）和安全灵活的filepath.WalkDir（支持递归、深度优先遍历及错误中断），同时强调了类型判断、错误处理、按需加载元数据等关键细节，帮助开发者写出更高效、更符合Go惯用法的文件系统操作代码。

在 Go 语言中，ioutil.ReadDir 已被弃用（自 Go 1.16 起），推荐使用 os.ReadDir 或 filepath.WalkDir 来遍历目录。下面介绍几种常用、安全且符合现代 Go 实践的方式。

使用 os.ReadDir 列出当前目录文件（推荐）

os.ReadDir 是轻量、高效、只读的目录遍历方式，返回 []fs.DirEntry，不加载完整文件信息（如内容或详细系统属性），适合快速列出文件名和基础类型判断。

• 它不会递归，仅读取指定目录下的一级条目
• 支持通过 entry.IsDir() 区分文件与子目录
• 比 os.ReadDir + os.Stat 组合更高效（避免多次系统调用）

示例：

package main

import (
    "fmt"
    "os"
)

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

    for _, entry := range entries {
        if entry.IsDir() {
            fmt.Printf("[DIR]  %s\n", entry.Name())
        } else {
            fmt.Printf("[FILE] %s\n", entry.Name())
        }
    }
}

使用 filepath.WalkDir 递归遍历整个目录树

当需要访问子目录及所有嵌套文件时，filepath.WalkDir 是标准且推荐的方式。它按深度优先顺序遍历，支持中断（返回非 nil error 可停止）。

• 回调函数接收路径字符串和 fs.DirEntry，无需额外 Stat
• 自动跳过权限不足的目录（可自定义错误处理）
• 相比旧版 filepath.Walk，性能更好、更安全

示例（只打印普通文件路径）：

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 // 忽略无法访问的路径（如 permission denied）
        }
        if !d.IsDir() {
            fmt.Println("File:", path)
        }
        return nil
    })
}

兼容旧代码：为什么不要用 ioutil.ReadDir

ioutil.ReadDir 在 Go 1.16 中已被移入 io/ioutil 包并标记为废弃，其底层调用 os.ReadDir 后又对每个条目执行 os.Stat，造成冗余系统调用，性能较差，且返回 []os.FileInfo 类型已不如 fs.DirEntry 轻量灵活。

• 如果你看到老项目里用了 ioutil.ReadDir，建议直接替换为 os.ReadDir
• 若需完整 FileInfo（如修改时间、大小），可对特定条目显式调用 d.Info()

小技巧：过滤文件类型或按名称排序

os.ReadDir 返回的条目默认是无序的（取决于文件系统）。如需排序，可手动排序；如需过滤（如只取 .go 文件），用简单条件判断即可：

entries, _ := os.ReadDir(".")
// 过滤并排序
var goFiles []string
for _, e := range entries {
    if !e.IsDir() && filepath.Ext(e.Name()) == ".go" {
        goFiles = append(goFiles, e.Name())
    }
}
sort.Strings(goFiles) // 需 import "sort"

不复杂但容易忽略：记得检查错误、区分目录/文件、优先用 fs.DirEntry 接口而非预加载全部元数据。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang遍历目录文件技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。