17370845950

Golang如何用ioutil ReadDir列出目录文件_Golang ReadDir文件列表与操作实践
ioutil.ReadDir用于读取目录内容,返回[]os.FileInfo,可遍历获取文件名、大小、类型等信息,支持按扩展名过滤;Go 1.16起推荐使用os.ReadDir,返回fs.DirEntry更高效。

在Go语言中,ioutil.ReadDir 是一个便捷的方法,用于读取指定目录下的文件和子目录信息。虽然从Go 1.16起官方推荐使用 os.ReadDir 替代 ioutil.ReadDir,但了解其用法仍有助于维护旧项目。下面介绍如何使用 ioutil.ReadDir 获取目录内容,并进行常见操作。

使用 ioutil.ReadDir 列出目录文件

注意:ioutil.ReadDir 在 Go 1.16 后已被弃用,建议新项目使用 os.ReadDir。但以下示例仍适用于老版本。

要列出某个目录下的所有条目,可以这样写:

package main

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

func main() {
    dir := "./" // 指定目录路径
    files, err := ioutil.ReadDir(dir)
    if err != nil {
        log.Fatal(err)
    }

    for _, file := range files {
        fmt.Println(file.Name())
    }
}

这段代码会打印当前目录下所有文件和文件夹的名称。

获取文件详细信息并分类

file 对象是 os.FileInfo 类型,包含丰富的元数据。我们可以判断它是文件还是目录,并进一步筛选:

  • file.IsDir() 返回 true 表示是目录
  • file.Mode().IsRegular() 可判断是否为普通文件
  • file.Size() 获取文件大小(字节)
  • file.ModTime() 获取最后修改时间

示例:分别列出文件和目录

for _, file := range files {
    if file.IsDir() {
        fmt.Printf("[DIR]  %s\n", file.Name())
    } else {
        fmt.Printf("[FILE] %s (%d bytes)\n", file.Name(), file.Size())
    }
}

过滤特定类型文件(如 .go 文件)

结合 path/filepath 中的 Ext 函数,可轻松实现按扩展名过滤:

import "path/filepath"

// ...

for _, file := range files {
    if !file.IsDir() {
        ext := filepath.Ext(file.Name())
        if ext == ".go" {
            fmt.Println("Go文件:", file.Name())
        }
    }
}

你也可以用 strings.HasSuffix 进行前缀或后缀匹配,比如查找以 "config" 开头的文件。

替代方案:使用 os.ReadDir(推荐)

Go 1.16+ 推荐使用 os.ReadDir,它返回更轻量的 fs.DirEntry,性能更好:

package main

import (
    "fmt"
    "os"
)

func main() {
    entries, err := os.ReadDir("./")
    if err != nil {
        panic(err)
    }

    for _, entry := range entries {
        info, _ := entry.Info()
        if entry.IsDir() {
            fmt.Printf("[DIR]  %s\n", entry.Name())
        } else {
            fmt.Printf("[FILE] %s (%d bytes)\n", entry.Name(), info.Size())
        }
    }
}

这种方式更现代、高效,且与模块化文件系统兼容性更好。

基本上就这些。ioutil.ReadDir 虽然简单易用,但在新项目中应优先选择 os.ReadDir。掌握目录遍历和文件属性提取,是文件处理的基础能力。不复杂但容易忽略的是错误处理和跨平台路径兼容问题,建议配合 filepath.Clean 或 filepath.Join 使用路径拼接。