filepath.WalkFunc 是函数类型而非可调用函数，需传入满足其签名的自定义函数或闭包给 filepath.Walk；返回 filepath.SkipDir 可跳过目录，返回其他非 nil 错误则终止遍历。
filepath.WalkFunc 本身并不存在 —— Go 标准库只有 filepath.Walk，它接收一个类型为 filepath.WalkFunc 的回调函数。这是初学者最常卡住的第一步：搜“WalkFunc”却找不到可直接调用的函数，实际要用的是 filepath.Walk。
为什么不能直接调用 WalkFunc？
filepath.WalkFunc 是一个函数类型定义，不是函数实体。它的签名是：type WalkFunc func(path string, info os.FileInfo, err error) error。你得自己写一个满足这个签名的函数（或闭包），再传给 filepath.Walk。
常见错误现象：
• 写 filepath.WalkFunc(...) 报错 “cannot call type”
• 把匿名函数直接塞进参数但漏了返回 error，导致编译失败或遍历中途静默终止
- 必须返回
error：返回filepath.SkipDir可跳过当前目录，返回其他非 nil error 会中断整个遍历 -
info可能为nil（比如路径权限不足），此时err非 nil，不应访问info.Name()等字段 - 路径
path是绝对路径还是相对路径，取决于你传给filepath.Walk的根路径
如何安全地过滤文件和跳过目录？
在回调里做判断是最常用场景，但要注意逻辑顺序和副作用。比如想跳过 .git 目录、只处理 .go 文件，不能只靠 strings.HasSuffix 判断后就 return —— 那样会误杀子目录里的合法文件。
正确做法是先检查是否为目录、再决定是否跳过；对文件再按扩展名过滤：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
err := filepath.Walk("/src", func(path string, info os.FileInfo, err error) error {
if err != nil {
return err // 权限错误等，原样返回让 Walk 停止
}
if info.IsDir() {
if info.Name() == ".git" || info.Name() == "vendor" {
return filepath.SkipDir // 跳过整个子树
}
return nil
}
if strings.HasSuffix(path, ".go") {
fmt.Println("found:", path)
}
return nil
})
- 跳过目录必须用
filepath.SkipDir，返回nil仍会递归进去 - 不要在回调里修改正在遍历的目录（如删文件、改权限），POSIX 下行为未定义，Windows 可能 panic
- 如果需要收集结果，建议用指针或闭包变量累积，避免并发写（
filepath.Walk是单协程同步执行）
Walk 和 WalkDir 有什么关键区别？
Go 1.16+ 引入了 filepath.WalkDir，它用 fs.DirEntry 替代 os.FileInfo，性能更好（避免多次 stat），且默认不跟随符号链接。如果你不需要符号链接解析，或想减少系统调用，优先选 WalkDir。
-
WalkDir的回调类型是filepath.WalkDirFunc，参数是fs.DirEntry，需显式调用entry.Info()才能拿到完整os.FileInfo（可能触发额外stat） -
WalkDir对 symlink 默认不展开；而Walk会跟随 symlink，可能造成循环遍历（除非手动检测） - 两者都不保证遍历顺序，如需排序，得自己把路径存 slice 后
sort.Strings
真正容易被忽略的点是：当你在回调里依赖 info.Size() 或 info.ModTime() 时，WalkDir 下若没调 Info() 就读不到这些字段；而 Walk 总是提供完整 FileInfo。选哪个，得看你要不要省那一次 stat，以及是否要控制 symlink 行为。
