必须用filepath.walkdir而非filepath.walk，因其避免冗余os.lstat、支持权限错误跳过（filepath.skipdir）、实测快20%–40%，且提供fs.direntry零开销操作；filepath.walk易因/proc权限错误中断、无symlink循环防护、不支持深度控制。
Go 标准库的 filepath.Walk 已足够轻量且健壮，直接封装它比手写递归更安全、更少出错。
为什么不用自己实现递归遍历
手写递归容易漏掉 symlink 循环、权限拒绝、路径长度溢出等边界情况；filepath.Walk 内部已处理这些，并支持提前终止（通过返回非 nil error）。它不依赖第三方包，编译后二进制无额外体积开销。
- 手动
os.ReadDir+ 递归需自行维护栈/队列，深度大时易栈溢出或内存失控 -
filepath.Walk是深度优先、惰性遍历，内存占用恒定 O(1)，适合大目录 - 它自动跳过无法访问的子目录（如无读权限），而手写逻辑常卡死在
os.Openpanic
如何用 filepath.Walk 构建可配置的树形输出
核心是把 walk 的每个 os.FileInfo 转成带缩进层级的字符串，同时过滤掉不想显示的条目（如隐藏文件、特定后缀）。
关键点：用闭包捕获当前层级，遇到目录时递增，回调返回前不递减——因为 filepath.Walk 不保证父子调用顺序严格嵌套，必须靠路径字符串拆分算层级：
func walkTree(root string, showHidden bool) {
filepath.Walk(root, func(path string, info os.FileInfo, err error) error {
if err != nil {
if os.IsPermission(err) {
return nil // 跳过无权限项
}
return err
}
if !showHidden && strings.HasPrefix(info.Name(), ".") {
if info.IsDir() {
return filepath.SkipDir // 避免进入隐藏目录
}
return nil
}
depth := strings.Count(strings.TrimSuffix(path, string(filepath.Separator)), string(filepath.Separator))
prefix := strings.Repeat("│ ", depth-1) + "├── "
fmt.Println(prefix + info.Name())
return nil
})
}
什么时候该换用 filepath.WalkDir
Go 1.16+ 引入的 filepath.WalkDir 更高效：它用 fs.DirEntry 避免了对每个文件都调用 os.Stat。如果你只关心名字、是否为目录、是否为符号链接，且不需要 os.FileInfo 的 ModTime 或 Size 等字段，就该切过去。
-
filepath.WalkDir比filepath.Walk快 20%~40%，尤其在含大量小文件的目录中 - 它默认不解析 symlink 目标，避免意外跨挂载点；若需跟随，得手动
os.Readlink+filepath.Join - 注意：
WalkDir的回调函数签名是func(path string, d fs.DirEntry, err error) error，d不是os.FileInfo
输出控制与常见陷阱
树形输出最常被忽略的是“目录排序”和“符号链接处理”。默认 filepath.Walk 不排序，结果顺序依赖文件系统底层，用户预期通常是字母序。
- 要稳定排序，得先用
os.ReadDir读取根目录，手动排序后再逐个 walk 子目录——但这就脱离了Walk的便利性；折中方案是在回调里收集所有路径，最后统一排序打印 - 符号链接默认被当作普通文件处理；若想展开链接目标，需在回调中判断
info.Mode()&os.ModeSymlink != 0，再用os.Readlink解析，但要注意避免无限循环（需记录已访问的 inode 或路径） - Windows 下路径分隔符是
\，但filepath.Walk内部已标准化为/，所以strings.Count(path, "/")在 Windows 上也安全
真正轻量的关键不是代码行数少，而是不引入状态管理、不假设文件系统行为、不重复造轮子处理错误分支。标准库的 Walk 系列函数已经覆盖了 95% 的真实需求，剩下的 5% 才值得你写自己的遍历逻辑。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
