filepath.Walk可递归遍历目录，通过回调函数处理每个文件或目录，支持跳过子目录或终止遍历，常用于文件扫描、过滤或统计场景。
在Go语言中，遍历目录文件是一个常见的需求，比如做文件扫描、日志清理或资源加载。Golang标准库提供了 filepath.Walk 函数，可以递归遍历指定目录下的所有子目录和文件，使用简单且功能强大。
filepath.Walk 基本用法
filepath.Walk 函数定义在 path/filepath 包中，其函数签名如下：
func Walk(root string, walkFn WalkFunc) error
它接收两个参数：
立即学习“go语言免费学习笔记（深入）”；
- root：起始目录路径
- walkFn：一个回调函数，类型为 WalkFunc，每次访问一个文件或目录时都会被调用
WalkFunc 的定义是：
type WalkFunc func(path string, info os.FileInfo, err error) error
其中：
- path：当前访问的文件或目录的完整路径
- info：文件的元信息（os.FileInfo）
- err：如果访问过程中出错，该值不为 nil
示例：打印所有文件和目录
下面是一个简单的例子，遍历指定目录并打印每个文件或目录的路径：
package main
import (
"fmt"
"os"
"path/filepath"
)
func main() {
root := "./testdir" // 替换为你想遍历的目录
err := filepath.Walk(root, func(path string, info os.FileInfo, err error) error {
if err != nil {
return err // 处理访问错误，比如权限不足
}
fmt.Println(path)
if info.IsDir() {
fmt.Printf("【目录】 %s\n", path)
} else {
fmt.Printf("【文件】 %s (大小: %d)\n", path, info.Size())
}
return nil
})
if err != nil {
fmt.Printf("遍历失败: %v\n", err)
}
}
控制遍历行为
通过在 WalkFunc 中返回特定的错误值，可以控制遍历流程：
- 返回 nil：继续遍历
- 返回 filepath.SkipDir：跳过当前目录的子目录遍历（仅对目录有效）
- 返回其他错误：终止整个遍历过程
例如，只遍历一级目录，不进入子目录：
if info.IsDir() && path != root {
return filepath.SkipDir // 不进入子目录
}
常见用途与注意事项
实际开发中，filepath.Walk 常用于：
- 查找特定后缀的文件（如 .log、.json）
- 统计文件数量或总大小
- 批量重命名或处理文件
注意点：
- 遍历顺序不保证，不要依赖特定顺序
- 遇到权限问题会传入非 nil 的 err，需判断处理
- 符号链接可能导致重复访问或循环，需自行判断
基本上就这些。filepath.Walk 是 Golang 中最实用的目录遍历工具，掌握它能轻松应对大多数文件系统操作场景。
