Golang遍历目录文件技巧分享

珍惜时间，勤奋学习！今天给大家带来《Golang遍历目录文件方法详解》，正文内容主要涉及到等等，如果你正在学习Golang，或者是对Golang有疑问，欢迎大家关注我！后面我会持续更新相关内容的，希望都能帮到正在学习的大家！

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

其中：

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

今天关于《Golang遍历目录文件技巧分享》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！