Go 推荐使用 filepath.WalkDir（Go 1.16+）高效遍历目录，支持按需过滤、跳过指定目录、统计文件信息及健壮错误处理。
用 Go 实现目录遍历很简单，核心是 filepath.Walk 或更现代的 filepath.WalkDir（Go 1.16+ 推荐），配合基础 I/O 和路径处理就能完成扫描、过滤、统计等常见管理任务。
使用 filepath.WalkDir 高效遍历目录
filepath.WalkDir 比旧版 Walk 更轻量，不强制读取所有子项元数据，支持提前终止，适合大多数场景。
- 传入根路径和一个
fs.DirEntry处理函数，每次进入目录或访问文件时调用 - 通过
entry.IsDir()区分文件与目录，避免重复os.Stat - 返回非 nil error 可中断遍历（比如遇到权限拒绝）
示例：打印所有 .go 文件路径
func main() {root := "./src"
err := filepath.WalkDir(root, func(path string, entry fs.DirEntry, err error) error {
if err != nil {
return err // 如 permission denied
}
if !entry.IsDir() && strings.HasSuffix(entry.Name(), ".go") {
fmt.Println(path)
}
return nil
})
if err != nil {
log.Fatal(err)
}
}
按需过滤与跳过特定目录
遍历时常需忽略 node_modules、.git、vendor 等目录，可在回调中判断后返回 filepath.SkipDir。
立即学习“go语言免费学习笔记（深入）”；
- 检查
entry.IsDir()为 true 且名字匹配忽略列表 - 返回
filepath.SkipDir即跳过该目录及其全部子项 - 注意大小写：Windows 下可能需忽略
.GIT，建议用strings.EqualFold
示例：跳过常见隐藏/构建目录
ignored := map[string]bool{
".git": true, "node_modules": true, "vendor": true, "build": true,
}
// 在 WalkDir 回调中：
if entry.IsDir() && ignored[strings.ToLower(entry.Name())] {
return filepath.SkipDir
}
统计文件类型与大小
遍历时可同步收集信息，比如按扩展名归类文件数、累计大小，无需二次遍历。
- 用
map[string]int64记录各后缀总大小，map[string]int记录数量 - 对非目录项调用
entry.Info()获取os.FileInfo，再取Size() - 注意：
entry.Info()在某些文件系统上可能触发额外 syscall，若只需大小且已知是文件，可考虑缓存或跳过
小技巧：用 path.Ext(path) 安全提取扩展名（含点），空字符串表示无后缀。
安全遍历与错误处理要点
真实项目中路径可能含符号链接、权限不足、设备忙等情况，健壮性很重要。
- 不要假设
entry.Info() != nil—— 某些情况（如挂载点断开）会返回 error - 对
os.ErrPermission通常记录警告但继续，而非直接 panic - 避免硬编码路径分隔符，始终用
filepath.Join拼接，filepath.ToSlash统一输出格式 - 大目录下考虑加 context 控制超时或取消：
filepath.WalkDir本身不支持 context，可用 goroutine + channel + select 封装
基本上就这些。Go 的标准库已足够支撑日常目录扫描与管理，关键在合理利用 WalkDir 的控制力，结合清晰的过滤逻辑和防御性错误处理。
