Golang文件夹遍历技巧与实现方法

还在苦恼 Golang 如何高效遍历文件夹？本文为你详细解读 Golang 中实现文件夹遍历的几种实用方法。主要介绍如何利用 `filepath.Walk` 和 `os.ReadDir` 递归遍历目录，并结合文件后缀、大小等条件进行筛选。`filepath.Walk` 适用于自动深度遍历，而 `os.ReadDir` 更适合自定义递归逻辑，方便灵活控制遍历过程。文章还讲解了如何配合 `strings.HasSuffix` 或 `filepath.Match` 按扩展名或通配符过滤文件，以及使用 `Glob` 进行简单模式匹配的技巧。跨平台开发时，建议结合 `Walk` 使用，确保兼容性。掌握这些方法，轻松实现 Golang 文件系统的各种操作需求，提升开发效率。

使用filepath.Walk或os.ReadDir递归遍历目录，结合后缀、大小等条件筛选文件，filepath.Walk适用于自动深度遍历，os.ReadDir适合自定义递归逻辑，配合strings.HasSuffix或filepath.Match可实现按扩展名或通配符过滤，Glob支持简单模式匹配但跨平台建议结合Walk使用。

在 Golang 中实现文件夹遍历，通常使用 filepath.Walk 或 os.ReadDir 配合递归方式。实际开发中，我们不仅需要遍历目录，还常需根据扩展名、文件大小或路径规则进行筛选。下面介绍几种常见且实用的实现方式。

使用 filepath.Walk 进行递归遍历

filepath.Walk 是最常用的目录递归方法，能自动深入子目录，调用传入的函数处理每个文件和目录。

基本用法如下：

walkFunc := func(path string, info os.FileInfo, err error) error {
    if err != nil {
        return err
    }
    fmt.Println(path)
    return nil
}
err := filepath.Walk("/your/dir", walkFunc)
if err != nil {
    log.Fatal(err)
}

该函数会访问每一个条目（包括子目录），你可以在 walkFunc 中加入逻辑判断，跳过目录或过滤特定文件。

按扩展名筛选文件

实际项目中常需只处理某种类型的文件，比如 .go、.txt 或 .json。可通过 strings.HasSuffix 判断后缀。

示例：只输出所有 .go 文件

filepath.Walk("./", func(path string, info os.FileInfo, err error) error {
    if err != nil {
        return err
    }
    if !info.IsDir() && strings.HasSuffix(info.Name(), ".go") {
        fmt.Println("Go file:", path)
    }
    return nil
})

注意判断 !info.IsDir() 可避免将目录误认为目标文件。

使用 os.ReadDir 实现手动递归

从 Go 1.16 起推荐使用 os.ReadDir 替代 ioutil.ReadDir。它返回 fs.DirEntry 类型，性能更好。

你可以自己控制递归逻辑，更灵活地跳过某些子目录。

示例：遍历目录并递归进入子目录

func scanDir(root string) error {
    entries, err := os.ReadDir(root)
    if err != nil {
        return err
    }
    for _, entry := range entries {
        path := filepath.Join(root, entry.Name())
        if entry.IsDir() {
            scanDir(path) // 递归进入
        } else {
            if strings.HasSuffix(entry.Name(), ".txt") {
                fmt.Println("Found txt:", path)
            }
        }
    }
    return nil
}

这种方式适合需要自定义递归条件的场景，比如跳过 node_modules 或 .git 目录。

结合 Glob 模式进行高级匹配

若想用通配符匹配路径，可使用 filepath.Glob。

例如查找当前目录及子目录中所有以 test 结尾的 Go 文件：

matches, _ := filepath.Glob("*/**/*_test.go")
for _, m := range matches {
    fmt.Println(m)
}

注意：Glob 不支持递归通配符 ** 在所有系统上表现一致，跨平台时建议配合 Walk 使用 path/filepath.Match 手动过滤。

基本上就这些。选择 Walk 还是 ReadDir + 递归 取决于是否需要精细控制流程。文件筛选建议结合后缀、大小、时间等条件，在回调中提前过滤，提升效率。

到这里，我们也就讲完了《Golang文件夹遍历技巧与实现方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于golang,文件筛选,filepath.Walk,文件夹遍历,os.ReadDir的知识点！