Golang中，filepath.Walk与WalkDir遍历目录结构有何不同之处？
- 内容介绍
- 文章标签
- 相关推荐
本文共计1033个文字，预计阅读时间需要5分钟。
它使用 `os.Lstat` 获取输入信息，遇到符号链接时默认不展开（除非目标是文件），整个遍历过程是深度优先、不可中断、不可跳过子树的。如果需要进入 `symlink` 指向的目录，或想在某个子目录下提前退出，则 `filepath.Walk` 做不到。
常见错误现象：filepath.Walk 遍历时发现某目录“消失”了——其实是该路径是个 symlink，而它被直接忽略；或者你想按字母序先处理 docs/ 再处理 src/，但它硬是按系统 readdir 返回顺序来，没法干预。
- 只适合简单扫描，比如收集所有
.go文件路径 - 回调函数签名是
func(path string, info os.FileInfo, err error) error，err 是读取失败时的错误，返回非 nil 会终止遍历 - 不区分 symlink 和普通目录，
info.IsDir()对 symlink 返回 false，容易误判
filepath.WalkDir 是 Go 1.16+ 推荐方式，支持 symlink 展开和细粒度控制
filepath.WalkDir 底层用 io/fs.ReadDir，返回的是 fs.DirEntry，轻量、不预加载完整 os.FileInfo，性能更好；更重要的是，它把“是否进入 symlink 目录”这件事交给你决定。
使用场景：需要安全处理软链、想跳过某些子目录（如 node_modules）、或要避免 stat 大量文件带来的开销。
本文共计1033个文字，预计阅读时间需要5分钟。
它使用 `os.Lstat` 获取输入信息，遇到符号链接时默认不展开（除非目标是文件），整个遍历过程是深度优先、不可中断、不可跳过子树的。如果需要进入 `symlink` 指向的目录，或想在某个子目录下提前退出，则 `filepath.Walk` 做不到。
常见错误现象：filepath.Walk 遍历时发现某目录“消失”了——其实是该路径是个 symlink，而它被直接忽略；或者你想按字母序先处理 docs/ 再处理 src/，但它硬是按系统 readdir 返回顺序来，没法干预。
- 只适合简单扫描，比如收集所有
.go文件路径 - 回调函数签名是
func(path string, info os.FileInfo, err error) error，err 是读取失败时的错误，返回非 nil 会终止遍历 - 不区分 symlink 和普通目录，
info.IsDir()对 symlink 返回 false，容易误判
filepath.WalkDir 是 Go 1.16+ 推荐方式，支持 symlink 展开和细粒度控制
filepath.WalkDir 底层用 io/fs.ReadDir，返回的是 fs.DirEntry，轻量、不预加载完整 os.FileInfo，性能更好；更重要的是，它把“是否进入 symlink 目录”这件事交给你决定。
使用场景：需要安全处理软链、想跳过某些子目录（如 node_modules）、或要避免 stat 大量文件带来的开销。