Go 1.16+ 推荐用 os.WalkDir 替代 filepath.Walk，因其按字典序遍历、避免 symlink 循环 panic、通过 DirEntry 减少 30% 系统调用，且支持主动跳过权限错误；需区分处理 IsNotExist、IsPermission 及其他错误。
Go 里用 os.WalkDir 实现递归搜索比 filepath.Walk 更稳
Go 1.16+ 推荐直接用 os.WalkDir，它默认按字典序遍历、不触发 symlink 循环 panic，且能通过 DirEntry 避免额外 stat 调用——filepath.Walk 在遇到权限不足目录时会直接中断，而 os.WalkDir 允许你用 filepath.SkipDir 主动跳过。
常见错误现象：filepath.Walk 遇到 permission denied 直接返回 error 并终止；实际项目中常漏判 os.IsPermission(err) 就 panic。
- 使用场景：需要快速列出所有
.go文件、跳过node_modules或.git目录时 -
os.WalkDir的回调函数签名为func(path string, d fs.DirEntry, err error) error，其中d可直接调用d.IsDir()和d.Type()，无需再os.Stat - 性能影响：省掉约 30% 的系统调用（尤其在大目录下），因为
DirEntry已含基础元信息
err := os.WalkDir(".", func(path string, d fs.DirEntry, err error) error {
if err != nil {
if os.IsPermission(err) {
return filepath.SkipDir // 主动跳过，继续遍历
}
return err
}
if !d.IsDir() && strings.HasSuffix(d.Name(), ".go") {
fmt.Println(path)
}
return nil
})
组合模式建模文件系统时，别把 Dir 和 File 做成接口实现体
用接口抽象 FileSystemNode 没问题，但若让 Dir 和 File 各自实现全部方法（比如 Size() 对 Dir 返回子项总大小、对 File 返回自身大小），会导致逻辑耦合和误用风险——Dir.Size() 容易被当成 O(1) 操作，实际是递归统计，可能卡住。
使用场景：构建类似 du -sh 的简易磁盘分析工具，或 IDE 的资源树缓存层。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 更安全的做法：只暴露
Accept(visitor Visitor)方法，把行为交给 visitor 实现（如SizeVisitor、PathVisitor），避免节点类型承担计算职责 -
Dir内部用[]FileSystemNode存子节点，但禁止对外暴露切片引用（防止外部篡改），提供Children()只读迭代器 - 兼容性注意：如果后续要支持虚拟文件系统（如内存 zip、HTTP FS），基于 visitor 的设计更容易替换底层存储
递归搜索中处理 symlink 必须显式控制深度或路径循环
Go 默认不自动检测 symlink 循环，os.WalkDir 会一路跟下去直到打开失败或栈溢出。Linux 下 /proc/self/root、macOS 的 /var/run 都可能隐含循环链接。
常见错误现象：程序卡死、goroutine stack overflow、CPU 占用飙高但无输出。
- 简单方案：维护已访问的
inode + device（用syscall.Stat_t.Dev和.Ino）去重，比字符串路径可靠得多 - 轻量方案：限制最大递归深度（例如
maxDepth := 20），在 visitor 中计数，超深则return filepath.SkipDir - 参数差异：
os.Lstat获取 symlink 自身信息，os.Stat会自动解引用——搜索阶段应优先用Lstat判断是否为 symlink
os.WalkDir 的 error 处理必须区分三类情况
不是所有 err 都该终止遍历。忽略分类会导致本可恢复的错误（如临时权限抖动）被当成致命错误，或真正致命的问题（如磁盘 I/O 错误）被静默吞掉。
-
os.IsNotExist(err)：路径已删除，跳过即可（return nil） -
os.IsPermission(err)：权限不足，通常return filepath.SkipDir（对文件则return nil） - 其他 error（如
syscall.ENOTDIR、io.ErrUnexpectedEOF）：大概率是文件系统损坏或并发修改，建议记录日志后return err终止整个 Walk
容易被忽略的是：同一个 err 在不同路径层级语义不同——根目录 Permission Denied 应该报错退出，子目录 Permission Denied 却可以跳过。判断依据只能是当前 path 是否等于起始搜索路径。
