GolangReadDir目录文件列出详解

各位小伙伴们，大家好呀！看看今天我又给各位带来了什么文章？本文标题是《Golang使用ReadDir列出目录文件详解》，很明显是关于Golang的文章哈哈哈，其中内容主要会涉及到等等，如果能帮到你，觉得很不错的话，欢迎各位多多点评和分享！

ioutil.ReadDir用于读取目录文件列表，返回按名称排序的FileInfo切片，适用于Go 1.16前版本，现推荐使用os.ReadDir替代。

在Go语言中，ioutil.ReadDir 是一个便捷的方法，用于读取指定目录下的所有文件和子目录信息。虽然从Go 1.16起官方建议使用 os.ReadDir 替代 ioutil.ReadDir（因为 ioutil 已被弃用），但了解其用法仍有助于维护旧项目。下面介绍如何使用 ioutil.ReadDir 获取文件列表，并进行常见操作。

使用 ioutil.ReadDir 读取目录内容

ioutil.ReadDir 返回一个按文件名排序的 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("[DIR]  %s\n", file.Name())
    } else {
        fmt.Printf("[FILE] %s (%d bytes)\n", file.Name(), file.Size())
    }
}
}

这段代码会输出目录中每个条目的名称、类型和大小。通过 file.IsDir() 可判断是否为目录。

筛选特定类型的文件（如 .txt）

实际开发中，我们常需要只处理某种扩展名的文件。可以结合 path/filepath 中的 Ext 函数实现过滤。

示例：列出所有 .txt 文件

package main
import (
"fmt"
"io/ioutil"
"log"
"path/filepath"
)
func main() {
dir := "./example"
files, err := ioutil.ReadDir(dir)
if err != nil {
log.Fatal(err)
}
fmt.Println("Text files:")
for _, file := range files {
    if !file.IsDir() && filepath.Ext(file.Name()) == ".txt" {
        fmt.Printf("- %s\n", file.Name())
    }
}
}

这里使用 filepath.Ext(file.Name()) 提取文件扩展名，并与目标格式比较。

获取完整路径并进一步操作

ioutil.ReadDir 返回的是相对条目，若需对文件进行打开或删除等操作，通常需要完整路径。

示例：打印每个文件的绝对路径

package main
import (
"fmt"
"io/ioutil"
"log"
"path/filepath"
)
func main() {
dir := "./example"
absDir, _ := filepath.Abs(dir) // 转为绝对路径
files, err := ioutil.ReadDir(absDir)
if err != nil {
log.Fatal(err)
}
for _, file := range files {
    fullPath := filepath.Join(absDir, file.Name())
    fmt.Printf("Processing: %s\n", fullPath)
    // 可在此处执行文件读取、重命名等操作
}
}

利用 filepath.Join 构造正确的跨平台路径，避免手动拼接带来的兼容性问题。

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

自 Go 1.16 起，标准库引入了更高效的 os.ReadDir，它返回 fs.DirEntry 类型，性能更好且是未来趋势。

等效写法：

package main
import (
"fmt"
"log"
"os"
)
func main() {
dir := "./example"
entries, err := os.ReadDir(dir)
if err != nil {
log.Fatal(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())
    }
}
}

这种方式更加现代，资源消耗更低，建议新项目直接采用。

基本上就这些。掌握目录遍历是文件处理的基础，理解不同API的差异能帮助你写出更稳定、可维护的Go程序。

以上就是《GolangReadDir目录文件列出详解》的详细内容，更多关于的资料请关注golang学习网公众号！