Go语言目录操作实战（使用os包的ReadDir实现高效目录遍历）

什么是 os.ReadDir？

os.ReadDir 是 Go 1.16 版本引入的一个函数，用于读取指定目录中的所有条目（包括文件和子目录），并以 []fs.DirEntry 类型返回。

相比旧版的 ioutil.ReadDir（已在 Go 1.16 被废弃），os.ReadDir 更加高效、简洁，并且直接集成在 os 包中，无需额外导入。

基本语法

func ReadDir(name string) ([]fs.DirEntry, error)

• name：要读取的目录路径（字符串）
• 返回值：一个 []fs.DirEntry 切片和一个错误值
• 如果目录不存在或无权限访问，会返回非 nil 的 error

实战：遍历当前目录

下面是一个完整的示例，展示如何使用 os.ReadDir 遍历当前工作目录，并打印出所有文件和子目录的名称：

package mainimport (	"fmt"	"os")func main() {	entries, err := os.ReadDir(".") // "." 表示当前目录	if err != nil {		fmt.Println("读取目录失败:", err)		return	}	fmt.Println("当前目录下的内容：")	for _, entry := range entries {		if entry.IsDir() {			fmt.Printf("[目录] %s\n", entry.Name())		} else {			fmt.Printf("[文件] %s\n", entry.Name())		}	}}

运行这段代码，你将看到类似如下的输出：

[目录] docs[文件] main.go[文件] README.md[目录] assets

进阶：递归遍历子目录

有时我们需要遍历整个目录树（包括所有嵌套的子目录）。这时可以结合递归函数来实现：

package mainimport (	"fmt"	"os"	"path/filepath")func walkDir(dirPath string, depth int) {	entries, err := os.ReadDir(dirPath)	if err != nil {		fmt.Printf("无法读取目录 %s: %v\n", dirPath, err)		return	}	indent := ""	for i := 0; i < depth; i++ {		indent += "  " // 用空格缩进表示层级	}	for _, entry := range entries {		fmt.Printf("%s%s", indent, entry.Name())		if entry.IsDir() {			fmt.Println("/")			subPath := filepath.Join(dirPath, entry.Name())			walkDir(subPath, depth+1) // 递归调用		} else {			fmt.Println()		}	}}func main() {	walkDir(".", 0)}

这个程序会以树状结构打印出整个目录的内容，非常适合用于构建文件浏览器或生成项目结构图。

常见问题与注意事项

• 权限问题：确保程序有权限访问目标目录，否则会返回 permission denied 错误。
• 路径格式：在 Windows 和 Linux/macOS 中路径分隔符不同，建议使用 filepath.Join 来拼接路径，保证跨平台兼容性。
• 性能考虑：对于包含大量文件的目录，ReadDir 会一次性加载所有条目到内存。如果处理超大目录，可考虑使用 os.File.Readdir 分批读取。

总结

通过本文，你已经掌握了如何使用 Go语言 的 os 包中的 ReadDir 函数进行 目录遍历。无论是简单列出文件，还是递归遍历整个目录树，ReadDir 都是一个强大而高效的工具。

记住这些 SEO关键词：Go语言、os包、ReadDir、目录遍历 —— 它们不仅是搜索高频词，更是你掌握文件系统操作的核心概念！

赶快动手试试吧！实践是掌握 Go语言 文件操作的最佳方式。