Go os.ReadDir 怎样按目录项类型筛选

在 Go 中按目录项类型筛选，最直接的入口是 os.ReadDir。它返回一组 os.DirEntry，每个目录项都可以先用 IsDir 和 Type 做轻量判断；只有确实需要大小、权限或修改时间时，再调用 Info 读取更完整的 FileInfo。

如果目标只是“列出子目录”或“找普通文件”，优先在 DirEntry 层完成筛选；不要在循环里对每个条目无条件调用 Info。同时要保留读取错误和 Info 的单项错误，因为目录内容可能在两次读取之间发生变化。

先看懂 os.ReadDir 返回的目录项

os.ReadDir(path) 会读取指定目录并返回 []os.DirEntry。返回结果按文件名排序，调用者可以直接遍历。DirEntry.Name 是条目的最后一级名称，不是完整路径；真正访问文件时，通常需要用目录路径和名称重新拼出路径。

package main

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

func main() {
	root := "./assets"
	entries, err := os.ReadDir(root)
	if err != nil {
		// 目录不存在、没有权限或读取失败时，不能继续使用 entries。
		fmt.Printf("读取目录失败：%v\n", err)
		return
	}

	for _, entry := range entries {
		// Name 只有最后一级名称，拼接完整路径时要保留 root。
		fullPath := filepath.Join(root, entry.Name())
		fmt.Printf("name=%s path=%s dir=%t type=%s\n",
			entry.Name(), fullPath, entry.IsDir(), entry.Type())
	}
}

这里的关键不是打印，而是先把 DirEntry 当作“目录枚举时拿到的轻量对象”。Name 解决命名，IsDir 解决目录判断，Type 提供类型位，Info 才会进一步拿到 FileInfo。

只保留子目录：优先使用 IsDir

如果需求是扫描一级目录、收集待处理的子目录，entry.IsDir() 就足够了。它比先调用 Info 再判断 FileInfo.IsDir() 更贴合这个问题，也让代码明确表达“当前只关心目录项类型”。

func listSubdirectories(root string) ([]string, error) {
	entries, err := os.ReadDir(root)
	if err != nil {
		// 目录级错误应直接返回，让调用方决定是否重试或提示用户。
		return nil, fmt.Errorf("read %q: %w", root, err)
	}

	dirs := make([]string, 0, len(entries))
	for _, entry := range entries {
		// 目录筛选只需要 DirEntry 的类型信息，不必先取完整 FileInfo。
		if !entry.IsDir() {
			continue
		}
		dirs = append(dirs, filepath.Join(root, entry.Name()))
	}
	return dirs, nil
}

这个函数只处理当前层，不会递归进入子目录。如果后续需要递归遍历，应单独考虑 io/fs.WalkDir 或递归策略，不要把“按类型筛选”和“遍历深度”混成一个隐式行为。

筛选普通文件时怎样使用 Type

DirEntry.Type() 返回文件模式中的类型位。常见判断可以写成 entry.Type().IsRegular()，目录则继续使用 IsDir。类型位适合做第一轮筛选，但它不等同于完整的权限、大小和时间信息。

func listRegularFiles(root string) ([]string, error) {
	entries, err := os.ReadDir(root)
	if err != nil {
		// 读取目录本身失败时，返回带路径的上下文错误。
		return nil, fmt.Errorf("read %q: %w", root, err)
	}

	files := make([]string, 0, len(entries))
	for _, entry := range entries {
		// 先排除目录，再判断类型位是否表示普通文件。
		if entry.IsDir() || !entry.Type().IsRegular() {
			continue
		}
		files = append(files, filepath.Join(root, entry.Name()))
	}
	return files, nil
}

如果你只需要“普通文件路径”，这个写法已经足够。不要用文件名后缀代替类型判断：report.txt 可能是目录名，扩展名也不能说明条目是否为符号链接。

什么时候必须调用 DirEntry.Info

当筛选条件涉及文件大小、权限、修改时间，或者你需要明确记录符号链接等细节时，调用 entry.Info()。它返回 FileInfo 和错误；条目可能在目录读取之后被删除或重命名，所以单个 Info 失败不一定意味着整次目录读取失败。

func listLargeFiles(root string, minSize int64) ([]string, error) {
	entries, err := os.ReadDir(root)
	if err != nil {
		// 目录级错误无法继续判断，直接返回。
		return nil, fmt.Errorf("read %q: %w", root, err)
	}

	result := make([]string, 0)
	for _, entry := range entries {
		// 类型位先做便宜的过滤，避免给目录或其他类型读取无关信息。
		if entry.IsDir() || !entry.Type().IsRegular() {
			continue
		}

		info, err := entry.Info()
		if err != nil {
			// 单个条目消失时跳过它，其他目录项仍可继续处理。
			fmt.Printf("跳过 %q：%v\n", entry.Name(), err)
			continue
		}
		if info.Size() >= minSize {
			result = append(result, filepath.Join(root, entry.Name()))
		}
	}
	return result, nil
}

还要注意符号链接语义：根据 io/fs.DirEntry 的定义，Info 描述的是链接自身，而不是链接指向的目标。若业务要跟随链接，需要另外设计目标解析和权限边界，不能把 Info 的结果误当成目标文件信息。

把目录读取错误和条目错误分开处理

os.ReadDir 的错误属于目录级别，通常应该返回；entry.Info 的错误属于单个条目，可以根据业务选择跳过、记录或终止。这样即使目录正在被其他进程清理，也不会把一个消失的文件误判为整个扫描失败。

如果目录很大或希望分批处理，可以先用 os.Open 打开目录，再调用 File.ReadDir(n)。当 n > 0 时它每次最多返回指定数量；当 n 时读取剩余全部条目。这里需要显式关闭文件句柄：

func countDirectoriesInChunks(root string, chunkSize int) (int, error) {
	f, err := os.Open(root)
	if err != nil {
		// 打开目录失败时没有需要关闭的句柄。
		return 0, fmt.Errorf("open %q: %w", root, err)
	}
	defer f.Close() // 函数返回时释放目录句柄，避免长时间扫描泄漏资源。

	count := 0
	for {
		entries, err := f.ReadDir(chunkSize)
		if err != nil && len(entries) == 0 {
			// 当前批次没有任何记录且出错，结束读取并返回错误。
			return count, fmt.Errorf("read entries: %w", err)
		}
		for _, entry := range entries {
			// 每批只统计目录，其他类型不进入计数。
			if entry.IsDir() {
				count++
			}
		}
		if len(entries) == 0 {
			// n 大于零时，空切片表示已经到目录末尾或发生了错误。
			return count, err
		}
	}
}

实际项目中还要根据目录是否可能被并发修改，决定遇到部分结果时是继续还是失败。核心判断顺序可以概括为：目录级错误先处理，类型能判断的先筛选，需要元数据时再取 Info，单项错误保留上下文。

常见误区与选择表

结语：先按类型分流，再按需取元数据

Go 的目录筛选可以保持很小：os.ReadDir 负责拿到条目，IsDir 负责目录判断，Type 负责类型位筛选，Info 负责补充元数据。把这几层职责分开，代码会更快表达真实需求，也更容易处理目录并发变化带来的单项错误。

相关问题

os.ReadDir 会递归读取子目录吗？

不会。它只读取传入路径的当前目录；递归遍历应单独使用递归逻辑或 io/fs.WalkDir。

为什么不直接对每个 DirEntry 调用 Info？

如果只需要目录或普通文件类型，IsDir 和 Type 已经能完成筛选。先筛选、后读取元数据可以减少无关的文件信息查询。

Type 为零就一定是普通文件吗？

常见文件系统上普通文件的类型位通常为空，但若业务必须确认大小、权限或符号链接语义，应调用 Info 并处理返回错误，不要只依赖名称或猜测。