在go语言中，有时我们需要获取一个特定目录下所有文件和文件夹的列表，但又不想递归地遍历其所有子目录。虽然filepath.walk函数功能强大，但它默认会遍历所有子目录，这在某些场景下并非我们所需。对于这种非递归的目录内容列表需求，os包中的readdir函数提供了简洁高效的解决方案。
核心函数：os.ReadDir
os.ReadDir函数是Go语言标准库中用于读取指定目录内容的专用工具。它的主要功能是读取给定目录的全部条目（包括文件和子目录），并以按文件名排序的切片形式返回这些条目。
函数签名：
func ReadDir(name string) ([]DirEntry, error)
- name：表示要读取的目录路径。可以是相对路径（如"./"）或绝对路径。
- []DirEntry：一个os.DirEntry类型的切片，包含了目录中的所有条目。
- error：如果读取目录时发生错误（例如目录不存在或没有读取权限），则返回一个错误对象。
os.DirEntry是一个接口类型，它提供了多种方法来获取目录条目的详细信息，例如名称、是否为目录等。
基本用法示例
以下是一个简单的示例，演示如何使用os.ReadDir函数列出当前目录下的所有文件和文件夹的名称：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"fmt"
"log"
"os"
)
func main() {
// 读取当前目录（"."）下的所有条目
entries, err := os.ReadDir("./")
if err != nil {
// 如果发生错误，使用log.Fatal打印错误并退出程序
log.Fatal(err)
}
fmt.Println("当前目录内容：")
// 遍历所有目录条目
for _, entry := range entries {
// 打印条目的名称
fmt.Println(entry.Name())
}
}代码解析：
- os.ReadDir("./")：尝试读取当前执行程序所在目录（由"./"表示）的内容。
- if err != nil { log.Fatal(err) }：这是Go语言中标准的错误处理模式。如果ReadDir返回错误，程序将通过log.Fatal打印错误信息并终止执行。
- for _, entry := range entries：遍历ReadDir返回的[]os.DirEntry切片。
- entry.Name()：os.DirEntry接口提供Name()方法，用于获取当前条目的文件名或目录名。
区分文件与目录
os.DirEntry接口还提供了IsDir()方法，可以方便地判断一个条目是文件还是目录。这对于需要根据类型进行不同处理的场景非常有用。
package main
import (
"fmt"
"log"
"os"
)
func main() {
dirPath := "./" // 可以更改为其他目录路径，例如 "/tmp"
entries, err := os.ReadDir(dirPath)
if err != nil {
log.Fatal(err)
}
fmt.Printf("目录 '%s' 的内容：\n", dirPath)
for _, entry := range entries {
if entry.IsDir() {
fmt.Printf("[目录] %s\n", entry.Name())
} else {
fmt.Printf("[文件] %s\n", entry.Name())
}
}
}代码解析：
- entry.IsDir()：此方法返回一个布尔值，如果条目是一个目录，则返回true；否则（即为文件、符号链接等），返回false。通过此判断，我们可以清晰地标识出每个条目的类型。
注意事项与总结
- 非递归性： os.ReadDir函数只会读取指定目录的直接内容，不会自动进入子目录进行遍历。如果您需要递归遍历，请考虑使用filepath.Walk。
- 排序： os.ReadDir返回的[]os.DirEntry切片是按文件名（字典序）排序的，这在很多情况下能提供便利。
- 错误处理： 始终检查os.ReadDir返回的错误。文件系统操作可能会因各种原因（如权限不足、目录不存在、路径错误等）而失败。
- os.DirEntry接口： 除了Name()和IsDir()，os.DirEntry还提供了Type()（返回fs.FileMode，包含文件类型位）和Info()（返回fs.FileInfo，提供更详细的文件信息）等方法，可以根据需求选择使用。
通过掌握os.ReadDir函数，您可以高效且精确地在Go语言中管理和操作文件系统，实现对单个目录内容的非递归式列表需求。
