优先用filepath.WalkDir（Go 1.16+），因其不强制stat、支持精准跳过子目录、能显式处理符号链接和权限错误；filepath.Walk易静默终止、不支持可控跳过且性能较差。
用 filepath.Walk 遍历目录是最直接的方式
Go 标准库的 filepath.Walk 就是专为递归遍历设计的，它自动处理符号链接、权限错误和子目录嵌套，比手写递归更健壮。它接受一个根路径和一个回调函数，每次访问文件或目录时都会调用该函数。
常见错误是把 filepath.Walk 和 filepath.WalkDir 混用：WalkDir 是 Go 1.16+ 引入的替代方案，它按字典序遍历且能跳过子树（返回 filepath.SkipDir），但默认不跟随符号链接；而 Walk 会跟随符号链接（可能引发循环），且顺序不确定。
- 若需跳过某些目录（比如
.git或node_modules），在回调中判断path并返回filepath.SkipDir - 若遇到权限拒绝（
os.ErrPermission），回调里直接return nil可继续遍历其余路径，不要 panic -
Walk对每个文件/目录都调用一次回调，包括目录本身——如只需文件，记得用info.IsDir()过滤
err := filepath.Walk("/tmp", func(path string, info os.FileInfo, err error) error {
if err != nil {
if errors.Is(err, os.ErrPermission) {
return nil // 忽略权限错误，继续
}
return err
}
if !info.IsDir() {
fmt.Println(path)
}
return nil
})
需要精确控制递归逻辑时，手动实现 os.ReadDir + 递归
当 filepath.Walk 的行为不符合需求——比如想严格限制递归深度、自定义排序、或避免符号链接展开——就得手动遍历。Go 1.16+ 推荐用 os.ReadDir（比 os.ReadDir 更快，不读取全部文件信息）配合递归调用。
容易踩的坑是没处理好错误传播：如果某次 os.ReadDir 失败（如目录被删除），不能直接 return，否则上层递归会中断；应记录错误并 continue 当前目录的其他项。
立即学习“go语言免费学习笔记（深入）”；
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 递归前先检查
info.IsDir()，避免对文件调用os.ReadDir导致not a directory错误 - 深度控制建议用参数传入当前层级，到达阈值后直接 return，不要靠 defer 或全局变量
-
os.ReadDir返回的是fs.DirEntry，调用.Info()才获取完整os.FileInfo，频繁调用会影响性能；如只需名字和是否为目录，用.Name()和.IsDir()即可
过滤文件类型或扩展名时，别在回调里反复调用 filepath.Ext
很多用户在 filepath.Walk 回调里对每个路径都跑一遍 filepath.Ext(path) 判断扩展名，这在大目录下有明显开销——filepath.Ext 内部要从后往前扫描字符串找最后一个 .。
更高效的做法是：提前把目标扩展名存成 map[string]struct{}，然后用 strings.HasSuffix 直接比对后缀（注意大小写）。如果扩展名固定且较短（如 ".go"），甚至可用 path[len(path)-len(ext):] == ext 手动截取，避免函数调用。
- Windows 路径分隔符是
\，但filepath.Ext能正确处理，不过strings.HasSuffix不关心路径格式，更通用 - 注意隐藏文件（如
.env）没有扩展名，filepath.Ext返回空字符串，strings.HasSuffix也会失败，需单独判断
filepath.Walk 在 macOS 上遇到 operation not permitted 怎么办
macOS Catalina 及以后版本对 /System、/usr、/Library 等路径有 SIP（系统完整性保护）限制，即使 root 权限也无法读取，filepath.Walk 会返回 operation not permitted 错误。
这不是代码 bug，而是系统策略。强行绕过需要给终端应用授予“完全磁盘访问”权限（系统设置 → 隐私与安全性 → 完全磁盘访问），但这属于用户侧配置，代码里无法解决。
- 遇到该错误时，
errors.Is(err, fs.ErrPermission)不会匹配，得用strings.Contains(err.Error(), "operation not permitted")做临时判断 - 生产环境应避免硬编码遍历系统路径，优先限定在用户目录（
$HOME）或明确指定的工作目录 - CI/CD 场景下若跑在 macOS runner 上，需确认 runner 配置已启用对应权限，否则遍历会静默失败
递归遍历看着简单，实际要稳住得盯住三件事：错误处理是否吞掉关键异常、符号链接是否意外成环、跨平台路径行为是否一致。尤其在构建工具或备份程序里，少一个 os.ErrPermission 判断，就可能让整个流程卡死在某个子目录上。
