ioutil.ReadDir是Go中读取目录内容的便捷函数，返回按文件名排序的fs.FileInfo切片，适用于旧项目维护；但自Go 1.16起已被os.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 包。这种模式适用于日志处理、配置加载等场景。
递归遍历子目录（注意 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。两者思路一致，迁移成本低。关键是根据需求判断是否需要递归、过滤或获取元数据。不复杂但容易忽略细节，比如错误处理和路径分隔符兼容性。
