filepath.WalkDir 比 Walk 快，因其默认用 io/fs.ReadDir 一次读取目录全部条目、避免逐个 os.Lstat；实测耗时仅 Walk 的 1/3～1/2，但回调中调用 os.Stat 会抵消优势。
filepath.WalkDir 为什么比 Walk 快
因为
默认使用
接口，一次读取目录全部条目（不逐个
），跳过不必要的系统调用；而老版
对每个文件/子目录都调用
，哪怕你只关心名字。实测在含数万小文件的目录下，
耗时通常只有
的 1/3～1/2。
但注意：快的前提是你没在回调里主动调用
或
—— 这会把性能优势直接吃掉。
遍历中提前退出的正确写法
的回调函数返回
，只要不是
就会终止遍历。但别直接
，Go 标准库约定用
跳过子树、用
或自定义错误（如
）中断整个流程。
找到第一个匹配文件就停：返回自定义错误（比如
），并在外层用
捕获
跳过某个子目录（比如
）：在回调中对目录名判断，返回
不要返回
这类带上下文的 error —— 容易和真实 I/O 错误混淆
匹配文件名时别忽略大小写和路径分隔符
Windows 下文件名不区分大小写，Linux/macOS 区分；而且
返回的
是纯文件名，不含路径，
在某些文件系统上不可靠。实际匹配应基于完整路径或明确归一化逻辑。
go语言参考手册 中文CHM版
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
立即学习
“
go语言免费学习笔记（深入）
”；
想跨平台匹配
：用
，而不是
想匹配路径中包含
的文件：用
，避免 Windows 的
分隔符干扰
避免用
做判断——
是传入的完整路径，
才是当前项名，二者语义不同
并发遍历目录树反而更慢？
别用 goroutine 包裹
并发跑多个目录——
本身是同步阻塞的，且磁盘 I/O 是瓶颈，加 goroutine 只会增加调度开销和系统调用竞争。真要提速，优先考虑：
用
替代遍历（如果路径模式简单，比如
，可用
实验包）
过滤掉不需要的子目录（如
、
）从源头减少遍历量
用
手动递归 +
复用
切片（仅当 profiling 确认内存分配是瓶颈时才值得）
真正容易被忽略的是：
不保证遍历顺序，也不承诺原子性——目录结构在遍历中途被修改（删/建/重命名），行为未定义。生产环境做文件发现类任务，得有兜底重试或快照机制。
WalkDirio/fs.ReadDirstatfilepath.Walkos.LstatWalkDirWalkos.Statos.LstatWalkDirerrornilreturn errors.New("found")filepath.SkipDirio.EOFerrFounderrStoperrors.Is(err, errStop).gitfilepath.SkipDirfmt.Errorf("found %s", name)WalkDirentry.Name()entry.Inode()README.mdstrings.EqualFold(entry.Name(), "readme.md")==/vendor/strings.Contains(filepath.ToSlash(path), "/vendor/")\filepath.Base(path) == "config.json"pathentry.Name()WalkDirWalkDirfilepath.Glob**/*.gogolang.org/x/exp/filepath/globnode_modules.gitos.ReadDirsync.Pool[]fs.DirEntryWalkDir