Go os.File.Readdirnames 怎样分批遍历大目录

处理目录项很多的场景时，我更愿意把目录当成一个可以持续读取的句柄，而不是一次性把全部名称装进内存。Go 的 os.File.Readdirnames 正好提供了这个边界：传入一个大于 0 的 n，每次最多取得 n 个名称，下一次调用从上次的位置继续。

官方文档：https://pkg.go.dev/os#File.Readdirnames

最稳妥的分批写法是：先处理本次返回的 names，再判断 err；io.EOF 表示目录已经读完，其他错误才应该作为失败返回。不要因为 names 非空就忽略 err，也不要把 Readdirnames 当成递归遍历或排序函数。

先看清 Readdirnames 的读取边界

Readdirnames(n) 返回的是名称切片和错误。n 大于 0 时，返回数量不会超过 n；同一个目录文件上连续调用，读取位置会继续向后推进。它只给出当前目录的名称，不会自动进入子目录，也不保证按文件名排序。

这几个边界决定了它适合批量导入、目录索引和清理任务：调用者可以每批处理一小段名称，处理完后再取得下一段，而不是保留整个目录的结果。

用固定批量读取目录名称

最小结构是先打开目录，再用正数批量大小循环读取。打开操作和关闭操作属于句柄生命周期的一部分，关闭应当放在成功打开之后，并且让调用者在函数返回时执行。

package main

import (
	"errors"
	"fmt"
	"io"
	"os"
)

func printNames(dirName string, batchSize int) error {
	// 正数批量大小才能把读取范围控制在每一批内。
	if batchSize 

上面的循环还少了一个关键分支：正常读完目录时需要退出，而不是把 EOF 当普通错误返回。实际代码通常使用 errors.Is(err, io.EOF)，并把“处理名称”和“判断错误”分开写清楚。

正确区分部分结果、EOF 和其他错误

分批循环最容易写错的地方，是把 names 和 err 当成互斥结果。读取过程中可能已经拿到一部分名称，同时得到一个错误；因此应当先消费已经返回的名称，再处理错误。io.EOF 只代表没有更多目录项，不等于这次任务失败。

package main

import (
	"errors"
	"fmt"
	"io"
	"os"
)

func walkBatches(dirName string, batchSize int, consume func(string) error) error {
	// 这里限制为正数，避免一次性读取整个目录。
	if batchSize 

这段代码的判断顺序有三个重点：第一，names 永远先处理；第二，用 errors.Is 判断 EOF，避免错误被包装后无法识别；第三，真正的读取错误保留在返回链路中，方便上层记录和定位。

按场景选择 n 的取值

当目录可能很大时，n 可以设为一个业务上容易处理的正数，例如 128、512 或 1000。这个数字不是 API 的固定推荐值，应该结合单个名称的后续工作量、队列容量和失败重试成本选择。

如果批处理逻辑需要可重试，建议让 consume 只处理当前批次，并在业务层记录已完成的名称。Readdirnames 只负责读取名称，不会替你建立持久化游标；进程中断后要不要从头扫描，取决于上层的索引或任务设计。

明确它不负责递归和排序

Readdirnames 只处理当前目录这一层。若名称对应子目录，需要调用者拼接路径并决定是否递归；若业务要求稳定顺序，也需要把名称收集后自行排序，或者改用适合该场景的目录读取接口。不要把目录顺序当成文件名排序结果。

我在这类代码里会把职责拆成三层：读取层只返回名称批次，处理层消费单个名称，策略层决定是否递归、是否排序以及如何记录进度。这样目录读取的错误不会被业务策略吞掉，批量大小也可以独立调整。

常见问题

Readdirnames 会递归子目录吗？

不会。它读取当前目录关联的名称；递归需要调用者根据名称拼接路径并再次打开子目录。

返回 names 后 err 不是 nil，还要处理 names 吗？

要先处理已经返回的名称，再判断错误。尤其是非 EOF 错误，部分结果可能仍然是本次读取能够得到的有效信息。

能不能用 n 等于 0 表示一批不读？

不建议这样理解。n 小于等于 0 的语义是读取剩余全部名称，不是返回空批次；需要分批时请使用大于 0 的批量大小。