Go语言如何遍历目录_Go语言filepath.Walk教程【精讲】-Golang-PHP中文网

优先用filepath.WalkDir（Go 1.16+），因其支持精准跳过子目录（return filepath.SkipDir）、避免重复os.Stat、明确处理权限错误，而filepath.Walk易静默终止、跳过不可控且性能差。

go语言如何遍历目录_go语言filepath.walk教程【精讲】

直接说结论：别用 filepath.Walk 做“精确控制遍历顺序”或“中途安全中断”的场景——它不支持跳过子目录的优雅方式，错误处理也容易掩盖真实问题；真要可控，优先考虑 filepath.WalkDir（Go 1.16+）。

为什么 `filepath.Walk` 容易踩坑

它用回调函数 + 全局 error 返回机制，导致两个典型问题：一是遇到权限错误（如 permission denied）时，整个遍历可能静默终止；二是想跳过某个子目录（比如 node_modules），只能靠在回调里 return nil，但这样无法阻止已入栈的子目录被继续访问——底层用的是栈模拟递归，跳过时机不可控。

常见错误现象包括：

遍历突然停在某个深层目录，没报错也没日志
明明过滤了 .git，结果仍看到它的子文件被传入回调
并发调用多个 filepath.Walk 时，因共享底层 os.FileInfo 而出现 panic（尤其在 Windows 上）

`filepath.WalkDir` 怎么用才对

它是 filepath.Walk 的现代替代，返回 fs.DirEntry 而非 os.FileInfo，开销更小，且明确支持跳过子目录：只要在回调中返回 filepath.SkipDir，当前目录下的所有子项立刻被跳过（不是“忽略”，是彻底不入栈）。

实操建议：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

始终检查 err 是否为 filepath.SkipDir，而不是只看 nil 或非 nil
若需并发安全遍历，自己封装 goroutine + channel，别依赖 WalkDir 内部行为
Windows 下注意路径分隔符，WalkDir 返回的 name 是相对路径，含 \，用 filepath.Join 拼接时会自动标准化

示例关键片段：

err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
    if err != nil {
        if errors.Is(err, os.ErrPermission) {
            return nil // 忽略权限错误，继续
        }
        return err
    }
    if d.IsDir() && (d.Name() == "node_modules" || d.Name() == ".git") {
        return filepath.SkipDir // ✅ 真正跳过
    }
    if !d.IsDir() {
        fmt.Println(path)
    }
    return nil
})