Golang目录文件读取方法全解析

本文深入解析了 Go 1.16+ 中推荐的目录读取方式 os.ReadDir，强调其轻量、高效、按需加载的优势，并指出它已完全取代被移除的 ioutil.ReadDir；通过 fs.DirEntry 的 IsDir() 和 Name() 方法可避免不必要的系统调用，提升大目录遍历性能，同时提醒务必使用 filepath.Join 拼接路径以确保跨平台兼容；文章还清晰区分了 os.ReadDir（单层列举）与 filepath.Walk（递归搜索）的核心适用场景，辅以简洁实用的代码示例，帮助开发者避开常见陷阱，写出更安全、健壮、高效的文件系统操作代码。

os.ReadDir 是 Go 1.16+ 推荐的目录读取方式

Go 1.16 起 os.ReadDir 取代了已弃用的 ioutil.ReadDir（后者在 Go 1.16 中已被移除）。它返回 []fs.DirEntry，比 os.FileInfo 更轻量，且支持按需调用 Info()，避免不必要的系统调用开销。

常见错误：仍尝试导入 "io/ioutil" 并调用 ioutil.ReadDir，会直接报错 undefined: ioutil.ReadDir。

• 用 os.ReadDir 替代 ioutil.ReadDir，无需额外依赖
• 若需完整 os.FileInfo（如文件大小、修改时间），对每个 fs.DirEntry 显式调用 .Info()
• 注意：os.ReadDir 不保证顺序，如需字典序请手动 sort.Slice

如何安全遍历目录并区分文件与子目录

fs.DirEntry 提供 IsDir() 和 Name() 方法，是判断类型和获取名称的首选——比先调用 .Info() 再查 IsDir() 更高效，因为不触发额外的 stat 系统调用。

典型误用：对每个条目都无条件调用 entry.Info()，导致性能下降，尤其在大目录中明显。

• 用 entry.IsDir() 快速判断是否为目录
• 用 entry.Name() 获取文件/目录名（不含路径）
• 拼接完整路径时，用 filepath.Join(dirPath, entry.Name())，别直接字符串拼接（Windows 下会出错）

os.ReadDir 与 filepath.Walk 的适用场景差异

os.ReadDir 只读一层，适合「列出当前目录内容」；filepath.Walk 是递归遍历，适合「搜索整个目录树」。两者不可互换，选错会导致逻辑漏洞或无限循环。

容易踩的坑：用 os.ReadDir 实现递归但忘记处理符号链接，或在 Walk 中重复打开同一目录引发 panic。

• 只需列出 /tmp 下的文件？→ 用 os.ReadDir("/tmp")
• 要在 /var/log 及其所有子目录中找 .log 文件？→ 用 filepath.Walk("/var/log", ...)
• 用 filepath.Walk 时，回调函数中若返回 filepath.SkipDir 可跳过子目录遍历

完整示例：安全读取目录并打印文件/目录标识

package main

import (
	"fmt"
	"os"
	"path/filepath"
)

func main() {
	entries, err := os.ReadDir(".")
	if err != nil {
		fmt.Printf("read dir error: %v\n", err)
		return
	}

	for _, entry := range entries {
		name := entry.Name()
		if entry.IsDir() {
			fmt.Printf("[DIR]  %s\n", name)
		} else {
			// 只有需要详细信息时才调用 Info()
			info, _ := entry.Info()
			fmt.Printf("[FILE] %s (%d bytes)\n", name, info.Size())
		}
	}
}

这个例子没用 filepath.Walk，也没做排序，就是最简可用的 os.ReadDir 实践。实际项目中如果要过滤隐藏文件（如 .git）、跳过特定后缀或并发处理，得在此基础上加判断和控制逻辑——那些不是 ReadDir 本身的责任，而是业务层的事。

本篇关于《Golang目录文件读取方法全解析》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！