Golang如何使用ioutil.ReadDir读取目录文件列表_Golang ReadDir目录文件遍历方法

P粉602998670 2025-11-26 00:00:00 次阅读

ioutil.ReadDir用于读取目录内容并返回按名称排序的文件信息切片，可遍历筛选特定类型文件，但从Go 1.16起推荐使用os.ReadDir以提升性能。

在Go语言中，ioutil.ReadDir 是一个便捷的方法，用于读取指定目录下的文件和子目录信息。虽然从 Go 1.16 开始该方法已被标记为弃用（建议使用 os.ReadDir），但在旧版本项目中仍常见其使用。下面介绍如何正确使用它来遍历目录并获取文件列表。

使用 ioutil.ReadDir 读取目录内容

ioutil.ReadDir 返回一个 []fs.FileInfo 切片，其中每个元素代表目录中的一个条目（文件或子目录），并按文件名字典序排序。

基本用法如下：

package main

import (
    "fmt"
    "io/ioutil"
    "log"
)

func main() {
    dir := "./example" // 替换为你要读取的目录路径
    files, err := ioutil.ReadDir(dir)
    if err != nil {
        log.Fatal(err)
    }

    for _, file := range files {
        if file.IsDir() {
            fmt.Printf("目录: %s\n", file.Name())
        } else {
            fmt.Printf("文件: %s (大小: %d bytes)\n", file.Name(), file.Size())
        }
    }
}

遍历目录并筛选特定文件类型

你可以通过检查文件名后缀来过滤特定类型的文件，例如只列出 .txt 文件。

for _, file := range files {
    if !file.IsDir() && strings.HasSuffix(file.Name(), ".txt") {
        fmt.Println("找到文本文件:", file.Name())
    }
}

别忘了导入 "strings" 包以使用 strings.HasSuffix。

替代方案：使用 os.ReadDir（推荐）

从 Go 1.16 起，官方推荐使用 os.ReadDir，它返回 []fs.DirEntry，性能更高且更轻量。

entries, err := os.ReadDir("./example")
if err != nil {
    log.Fatal(err)
}
for _, entry := range entries {
    info, _ := entry.Info()
    if entry.IsDir() {
        fmt.Printf("目录: %s\n", entry.Name())
    } else {
        fmt.Printf("文件: %s (%d bytes)\n", entry.Name(), info.Size())
    }
}

这种方式避免了完整读取文件元信息的开销，仅在需要时调用 entry.Info()。

基本上就这些。如果你还在使用旧版本 Go，ioutil.ReadDir 可用；但新项目建议直接采用 os.ReadDir。