filepath.WalkDir比Walk更适合统计目录大小，因其默认使用fs.DirEntry避免冗余stat调用，仅对普通文件按需调用Info()获取Size()，性能提升2–5倍；而Walk强制为每个路径执行os.Stat，开销大。
filepath.WalkDir 为什么比 Walk 更适合统计目录大小
因为 filepath.WalkDir 默认以深度优先顺序遍历，且不自动读取子目录内容（除非你显式调用 ReadDir），避免了重复 stat 或隐式 IO；更重要的是它返回的 fs.DirEntry 对象自带 Size() 方法，对常规文件可直接获取大小，无需额外 os.Stat 调用——这对性能敏感的递归统计很关键。
而老的 filepath.Walk 每次回调都传入完整 os.FileInfo，底层会强制执行一次 stat 系统调用，即使你只关心路径名或大小，也逃不掉开销。
实操建议：
- 始终用
filepath.WalkDir替代filepath.Walk做纯遍历+大小累加场景 - 遇到符号链接时，默认不跟随（
filepath.WalkDir不解析 symlink 目标），如需跟随，得自己用os.Readlink+os.Stat处理 - 注意：如果目录里有挂载点（如
/proc、/sys）或权限受限子目录，WalkDir会返回 error，需在回调中判断并跳过，否则整个遍历提前终止
如何正确累加文件大小并跳过错误项
核心是把累加逻辑放在 WalkDirFunc 回调里，并对每个 fs.DirEntry 判断类型和错误。常见错误包括：权限不足、路径不存在、设备文件无法读取大小（Size() 返回 0）、符号链接目标不可达等。
立即学习“go语言免费学习笔记（深入）”；
示例片段（关键逻辑）：
var total int64
err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
if err != nil {
// 权限拒绝、路径失效等，打印警告但继续
log.Printf("skip %s: %v", path, err)
return nil // 不返回 err，否则遍历中断
}
if !d.IsRegular() {
return nil // 忽略目录、设备、socket 等非普通文件
}
info, err := d.Info() // 注意：这里才触发 stat，仅对普通文件调用
if err != nil {
log.Printf("cannot stat %s: %v", path, err)
return nil
}
total += info.Size()
return nil
})
注意点：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
d.IsRegular()是轻量判断，比info.Mode().IsRegular()少一次系统调用 - 不要在每次回调都无条件调用
d.Info()，它对非普通文件也触发stat，浪费资源 - 若需严格区分“跳过”和“终止”，可在特定错误（如磁盘 I/O 错误）上返回非 nil error 终止遍历
大目录下统计变慢？小心隐式 ReadDir 和 syscall 开销
虽然 filepath.WalkDir 不自动 ReadDir，但如果你在回调里对某个目录节点调用 os.ReadDir 或 d.Info()，就会触发实际读取——尤其当目录含数万文件时，ReadDir 本身可能成为瓶颈。
优化方向：
- 只对
d.IsDir()为 true 的条目，且你**确实需要其子项元信息**时，才调用os.ReadDir；单纯统计大小不需要遍历子目录内容 - 避免在回调里打开文件、读取内容、计算 hash 等重操作
- 考虑用
runtime.GOMAXPROCS(1)防止默认多线程调度带来额外上下文切换（I/O 密集型任务通常单协程更稳） - Linux 下可配合
find . -type f -printf "%s\n" | awk '{sum += $1} END {print sum}'做对比验证，确认 Go 实现没因 syscall 频繁而拖慢
符号链接和硬链接怎么处理才不重复计数
filepath.WalkDir 默认不解析符号链接，所以软链接文件本身（link 文件）会被当作普通文件计入大小（通常是几十字节），而它的目标不会被自动访问。这符合“按路径统计”的直觉，但不符合“按磁盘占用统计”的需求。
硬链接则更隐蔽：多个硬链接指向同一 inode，os.FileInfo.Size() 返回相同值，但累加时会重复计数。
解决办法：
- 若要真实磁盘占用，需记录已见过的
(dev, ino)对（用info.Sys().(*syscall.Stat_t).Dev和Ino），跳过重复 inode - 若要跟随符号链接，得在回调中检测
d.Type() & fs.ModeSymlink != 0，再用os.Stat获取目标信息，并检查是否已计入该 inode - 注意：跨文件系统符号链接会导致
os.Stat失败，需捕获 error 并降级处理
inode 去重逻辑容易漏掉并发安全或内存泄漏，生产环境建议用 map[uint64]struct{} 存 dev/ino 组合，遍历完及时清理。
