go语言遍历目录最常用、最推荐的方式是 filepath.Walk,它 递归 访问目录树并调用 回调函数;Go 1.16+ 新增更高效的 filepath.WalkDir,基于 fs.DirEntry 减少开销。

Go 语言中遍历目录最常用、最推荐的方式是使用 filepath.Walk,它能递归访问目录树中的每个文件和子目录,并对每个路径调用你提供的 回调函数。
filepath.Walk 基本用法
filepath.Walk 接收两个参数:起始路径(字符串)和一个类型为 filepath.WalkFunc 的函数。该函数会在每次访问到一个路径时被调用,签名如下:
func(path String, info os.FileInfo, err Error) error
其中:
立即学习“go 语言免费学习笔记(深入)”;
- path 是当前访问的绝对或相对路径(取决于你传入的起始路径)
- info 是该路径对应的文件 / 目录元信息(可用
info.IsDir()判断是否为目录) - err 表示访问该路径时是否出错(比如权限不足、路径不存在等)
- 函数返回
error:若返回非 nil 错误,遍历会立即终止;若返回filepath.SkipDir,则跳过当前目录及其子目录(常用于过滤)
遍历并打印所有文件路径
下面是一个简单例子,只打印普通文件路径(跳过目录):
package main
import (
“fmt”
“os”
“path/filepath”
)
func main() {
err := filepath.Walk(“.”, func(path string, info os.FileInfo, err error) error {
if err != nil {
return err // 遇到访问错误直接返回,终止遍历
}
if !info.IsDir() {
fmt.Println(path)
}
return nil // 继续遍历
})
if err != nil {
fmt.printf(“ 遍历出错: %vn”, err)
}
}
跳过特定目录或文件
想跳过 node_modules 或 .git 这类目录?在回调中判断路径名,返回 filepath.SkipDir 即可:
- 如果
info.IsDir() && filepath.Base(path) == "node_modules",返回filepath.SkipDir - 如果只想处理
.go文件,可加判断:if filepath.Ext(path) != ".go" {return nil} - 注意:跳过目录必须在进入该目录前决定,所以要在
info.IsDir()为 true 且满足条件时立即返回filepath.SkipDir
替代方案:filepath.WalkDir(Go 1.16+)
Go 1.16 引入了更高效、更安全的 filepath.WalkDir,它使用 fs.DirEntry(轻量级 接口,不强制读取完整 FileInfo),适合大目录场景:
- 回调函数类型是
fs.WalkDirFunc,签名:func(path string, d fs.DirEntry, err error) error -
d可快速获取名称(d.Name())、是否为目录(d.IsDir()),需显式调用d.Info()才获取完整 FileInfo(有额外开销) - 同样支持
fs.SkipDir跳过目录
基本上就这些 —— Walk 简单直接,WalkDir 更现代高效,按需选用即可。