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("遍历出错: %v\n", 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 更现代高效，按需选用即可。
