os.walkdir 是唯一合理选择，因其返回的 fs.direntry 零开销提供基础元信息，避免 filepath.walk 的重复 os.stat、权限错误中断及符号链接循环问题。
用 os.WalkDir 而不是 filepath.Walk，否则统计会慢 2–5 倍、权限错误直接中断、符号链接可能循环卡死。
为什么 os.WalkDir 是唯一合理选择
老代码常用 filepath.Walk，但它对每个路径都强制调用 os.Stat——哪怕你只想要文件名或判断是否为普通文件。而 os.WalkDir 返回的 fs.DirEntry 已含基础元信息：d.IsRegular()、d.IsDir()、d.Name() 全部零开销；只有真要文件大小时才需显式调用 d.Info()。
常见错误现象包括：
-
filepath.Walk遇到/proc或权限受限目录（如/root/.cache）直接返回error并终止遍历 -
os.WalkDir在回调中遇到os.IsPermission(err)时，可安全返回filepath.SkipDir继续 - 手动用
os.ReadDir+ 递归容易漏判io.EOF或忽略 symlink 循环，导致栈溢出
如何正确累加大小并跳过问题路径
核心是把所有判断和累加逻辑收在单个回调里，且严格区分“跳过”和“终止”。d.IsRegular() 必须放在 d.Info() 之前——后者对非普通文件也会触发 stat 系统调用，纯浪费。
- 遇到
err != nil：先检查os.IsNotExist(err)或os.IsPermission(err)，满足则return filepath.SkipDir；其他错误（如磁盘 I/O 故障）才return err中断 - 非普通文件（目录、设备、socket、fifo）一律
return nil，不调d.Info() - 只对普通文件调
info, err := d.Info()，失败则打日志并return nil（例如某些挂载点里的伪文件Size()返回 0，但Info()会失败） - 累加用
atomic.AddInt64(&total, info.Size())，避免并发读写竞争（即使单 goroutine 也建议养成习惯）
大规模下必须主动控制的三个风险点
大目录（如 /usr、容器镜像层）下，os.WalkDir 默认行为仍可能拖慢甚至卡死：
-
符号链接循环：Linux 的
/proc/self/root、macOS 的/var/run常含隐式循环链，os.WalkDir不检测也不限制深度，必须自己维护已访问路径集（map[string]bool）或计数器 -
挂载点穿透：默认会跨 mount point 进入
/sys、/dev等虚拟文件系统，它们不占磁盘但ReadDir极慢，应在回调开头用os.Stat检查info.Sys().(*syscall.Stat_t).Dev判断是否与根目录同设备号 -
海量小文件调度开销：不要在回调里启动 goroutine 处理每个文件——上下文切换成本远超遍历本身；如需并发（如边统计边哈希），用带缓冲 channel 控制 worker 数量（
make(chan string, 1000)），别无脑go func(){}()
真正难的不是写完，而是让统计结果既快又准：跳过不该进的目录、不被 symlink 带偏、不因一个坏文件全盘失败——这些细节不在 API 文档里，全靠踩坑堆出来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
