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

2次阅读

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

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

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

站长
版权声明:本站原创文章,由 站长 2025-12-21发表,共计1403字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
1a44ec70fbfb7ca70432d56d3e5ef742
text=ZqhQzanResources