如何在Golang中使用ioutil.ReadDir列出文件_Golang ReadDir文件列表与操作实践-Golang-PHP中文网

如何在Golang中使用ioutil.ReadDir列出文件_Golang ReadDir文件列表与操作实践

P粉602998670

发布： 2025-12-05 15:26:02

原创

796人浏览过

ioutil.ReadDir是Go中读取目录内容的便捷函数，返回按文件名排序的fs.FileInfo切片，适用于旧项目维护；但自Go 1.16起已被os.ReadDir取代，后者性能更高、支持懒加载。

如何在golang中使用ioutil.readdir列出文件_golang readdir文件列表与操作实践

在Golang中，ioutil.ReadDir 是一个便捷函数，用于读取目录中的文件和子目录列表。虽然从 Go 1.16 开始官方建议使用 os.ReadDir 替代 ioutil.ReadDir，但了解其用法仍有实践价值，尤其在维护旧项目时。

使用 ioutil.ReadDir 列出文件

ioutil.ReadDir 返回一个按文件名排序的 fs.FileInfo 切片，每个元素代表目录中的一个条目。

基本用法如下：

package main

import (
    "fmt"
    "io/ioutil"
)

func main() {
    dir := "./" // 指定要读取的目录
    files, err := ioutil.ReadDir(dir)
    if err != nil {
        fmt.Println("读取目录失败:", err)
        return
    }

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

登录后复制

这段代码会列出当前目录下所有条目，并区分文件和目录，同时显示文件大小。

立即学习“go语言免费学习笔记（深入）”；

筛选特定类型文件

实际开发中，常需过滤出特定扩展名的文件，比如只列出 .txt 文件。

可以通过检查文件名后缀实现：

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

登录后复制

别忘了导入 strings 包。这种模式适用于日志处理、配置加载等场景。

Docky AI

多合一AI浏览器助手，解答问题、绘制图片、阅读文档、强化搜索结果、辅助创作

查看详情

递归遍历子目录（注意 ioutil.ReadDir 不支持）

ioutil.ReadDir 只读取单层目录，不包含递归功能。若需遍历子目录，可结合递归函数手动实现。

示例：递归打印所有文件

func walkDir(path string) {
    files, err := ioutil.ReadDir(path)
    if err != nil {
        fmt.Println("访问路径失败:", path, err)
        return
    }

    for _, file := range files {
        filepath := path + "/" + file.Name()
        if file.IsDir() {
            fmt.Println("[进入目录]", filepath)
            walkDir(filepath) // 递归调用
        } else {
            fmt.Println("[文件]", filepath)
        }
    }
}

登录后复制

该函数能深入每一级子目录，适合构建文件索引或批量处理任务。

推荐迁移到 os.ReadDir（Go 1.16+）

自 Go 1.16 起，ioutil.ReadDir 被标记为废弃，推荐使用 os.ReadDir，它返回 fs.DirEntry 类型，性能更高且更灵活。

等效写法：

entries, err := os.ReadDir("./")
if err != nil {
    log.Fatal(err)
}
for _, entry := range entries {
    info, _ := entry.Info()
    fmt.Printf("%s: %v bytes\n", entry.Name(), info.Size())
}

登录后复制

新 API 更轻量，因为 DirEntry 提供懒加载能力，仅在需要时才调用 Info() 获取完整信息。

基本上就这些。掌握 ioutil.ReadDir 的使用有助于理解 Go 的文件系统操作逻辑，但在新项目中应优先采用 os.ReadDir。两者思路一致，迁移成本低。关键是根据需求判断是否需要递归、过滤或获取元数据。不复杂但容易忽略细节，比如错误处理和路径分隔符兼容性。

以上就是如何在Golang中使用ioutil.ReadDir列出文件_Golang ReadDir文件列表与操作实践的详细内容，更多请关注php中文网其它相关文章！