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())
}
}
这段代码会打印当前目录下所有文件和文件夹的名称。
立即学习“go语言免费学习笔记(深入)”;
获取文件详细信息并分类
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 使用路径拼接。










