filepath.Walk 是遍历嵌套目录最简单可靠的方案，自动处理符号链接、权限错误和循环引用，深度优先同步遍历，回调中需用 info.IsDir() 和 strings.HasSuffix 等判断类型与后缀，避免重复 stat 或手动 readDir。
用 filepath.Walk 遍历嵌套目录最简单也最可靠
Go 标准库的 filepath.Walk 就是专为这个场景设计的，它自动处理符号链接、权限错误、循环引用等边界情况，比手写递归更健壮。filepath.Walk 是深度优先、非并发的同步遍历，适合绝大多数本地文件系统扫描需求。
常见错误是直接用 os.ReadDir + 手动递归，结果遇到 permission denied 就 panic，或者没处理 os.IsPermission 导致中断；而 filepath.Walk 会把这类错误传给回调函数，由你决定跳过还是终止。
- 回调函数签名必须是
func(path string, info os.FileInfo, err error) error - 返回
filepath.SkipDir可跳过当前目录（比如跳过.git），返回其他非 nil error 会终止遍历 -
info是调用os.Lstat获取的，对符号链接返回链接本身信息，不是目标文件
需要过滤文件类型？在回调里用 info.IsDir() 和 strings.HasSuffix
遍历本身不区分文件/目录，所有路径都进回调。真正做“只处理 .go 文件”或“跳过目录”逻辑，必须在回调函数里判断 info.IsDir() 和扩展名。
注意：不要在回调里对目录路径调用 os.ReadDir —— 这会和 filepath.Walk 的内部逻辑冲突，可能重复遍历或 panic。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 只处理普通文件：
if !info.IsDir() { ... } - 匹配后缀：
if strings.HasSuffix(path, ".go") { ... }，注意path是完整路径，不是文件名 - 想提取文件名用
filepath.Base(path)，别用strings.Split，Windows 路径分隔符会出错
遇到 symlink 循环或权限问题？靠回调返回值控制行为
filepath.Walk 默认不会解符号链接，但如果目录结构里有软链指向父目录（比如 dir/sub -> ..），filepath.Walk 仍可能陷入无限循环——它不主动检测循环，只依赖系统 openat 层的限制（通常最多 40 级嵌套）。
权限错误更常见：/root/.ssh 或某些容器挂载点常返回 operation not permitted，这时 err != nil 且 info 为 nil，必须显式检查并返回 nil 继续遍历，否则整个 walk 会提前退出。
- 安全写法：
if err != nil { if os.IsPermission(err) || os.IsNotExist(err) { return nil } else { return err } } - 要主动跳过特定目录（如
node_modules），在进入前判断：if filepath.Base(path) == "node_modules" && info.IsDir() { return filepath.SkipDir } - 想记录错误但不停止，用
log.Printf+ 返回nil，别忽略err
性能敏感？避免在回调里做重操作，别用 os.Stat 二次查询
filepath.Walk 回调里的 info 已经是 os.Lstat 结果，包含 size、modtime、mode 等全部元数据。如果再对同一路径调用 os.Stat，就是多余 syscall，尤其在 SSD/NVMe 上虽快，但在大量小文件场景下会显著拖慢速度。
另一个常见低效点：在回调里频繁字符串拼接路径（比如 path + "/xxx"），应改用 filepath.Join(path, "xxx")，它自动处理分隔符和冗余斜杠。
- 获取文件大小直接用
info.Size()，别os.Stat(path).Size() - 判断是否为普通文件用
info.Mode().IsRegular()，不是!info.IsDir()（设备文件、socket 等也非目录但不是常规文件） - 如果只需文件名列表，别在回调里
append到全局 slice——并发不安全，且内存分配不可控；考虑用 channel + goroutine 分流，但得权衡复杂度
递归深度本身不是问题，Go 默认栈足够深；真正卡住的往往是 I/O 等待或误判了符号链接语义。别为了“看起来更可控”就弃用 filepath.Walk 改手写递归——除非你明确需要并发遍历或自定义访问顺序。
