如何使用Golang遍历目录文件_Golang filepath Walk方法说明

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，则跳过当前目录及其子目录（常用于过滤）

遍历并打印所有文件路径

下面是一个简单例子，只打印普通文件路径（跳过目录）：

万知

万知: 你的个人AI工作站

156

查看详情

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 更现代高效，按需选用即可。

以上就是如何使用Golang遍历目录文件_Golang filepath Walk方法说明的详细内容，更多请关注php中文网其它相关文章！