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

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() 可判断是否为目录。
立即学习“go语言免费学习笔记（深入）”；
筛选特定类型的文件（如 .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()) 提取文件扩展名，并与目标格式比较。

							

								
								

									MiniMax Agent
									
MiniMax平台推出的Agent智能体助手
								
								下载 
							
						
获取完整路径并进一步操作
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程序。