Go os.ReadDir 保留目录项顺序并跳过符号链接

如果目录索引需要每次得到一致的文件名顺序，直接使用 os.ReadDir(path)；它会把目录项按文件名排序。遍历时再检查 DirEntry.Type() 是否包含 os.ModeSymlink，就能跳过符号链接本身，不会顺着链接去读取目标。

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

“保留顺序”要先说清楚是哪一种顺序：os.ReadDir 返回稳定的文件名排序；File.ReadDir 返回底层目录顺序，适合分批读取但不保证字典序。

• 稳定排序：用 os.ReadDir，返回前已经按文件名排序。
• 跳过链接：用 entry.Type()&os.ModeSymlink 判断当前目录项。
• 大目录：打开目录后调用 File.ReadDir(n)，按批次控制内存。

先把两种目录顺序分开

os.ReadDir(path) 适合构建目录索引、生成清单或做可重复的展示，因为它一次读取目录并按文件名排序。这个排序发生在返回切片之前，调用方不需要再写 sort.Slice。

另一种写法是先 os.Open，再调用文件对象的 ReadDir(n)。当 n>0 时它最多返回 n 项，后续调用继续读取；返回的是目录顺序，不等同于文件名排序。两者的选择取决于你更关心确定性还是批量处理。

用 DirEntry.Type 跳过符号链接

DirEntry 代表当前目录中的一项，Type 只返回类型位，Info 在遇到符号链接时描述的也是链接本身，而不是链接目标。因此过滤链接时应先判断类型，再决定是否继续处理。

package main

import (
    "fmt"
    "os"
)

func listRegularEntries(dir string) error {
    // os.ReadDir 返回按文件名排序的目录项，适合生成稳定清单。
    entries, err := os.ReadDir(dir)
    if err != nil {
        return fmt.Errorf("读取目录失败: %w", err)
    }

    for _, entry := range entries {
        // 先过滤链接本身，避免后续逻辑把链接目标当成普通项。
        if entry.Type()&os.ModeSymlink != 0 {
            continue
        }

        // 保留普通文件和真实目录；名称顺序沿用 os.ReadDir 的排序。
        kind := "文件"
        if entry.IsDir() {
            kind = "目录"
        }
        fmt.Printf("%s: %s\n", kind, entry.Name())
    }
    return nil
}

这里没有调用 entry.Info() 来完成普通过滤，因为读取额外元数据并不是排序所必需的。若后续确实需要权限、大小或修改时间，再对已经保留下来的项调用 Info()，并单独处理文件在遍历期间被删除或改名的错误。

大目录为什么要换成 File.ReadDir

当目录项很多时，可以用 os.Open 配合 ReadDir(n) 分批处理，减少一次性保留全部目录项的压力。要注意，分批接口按目录顺序返回；如果业务要求全局文件名排序，就需要把名称收集后排序，或者回到 os.ReadDir 的一次性读取方式。不能只对每一批排序后就宣称整个目录有序。

常见问题

os.ReadDir 会保留创建目录时的原始顺序吗？

不会。它返回的是按文件名排序的结果；如果需要底层目录顺序，应使用打开后的文件对象调用 ReadDir。

entry.IsDir 能识别符号链接指向的目录吗？

不要用它代替链接过滤。先判断 ModeSymlink，再对确认保留的项使用 IsDir，语义更清楚。

过滤符号链接是否等于安全隔离目录？

不等于。它只决定当前遍历是否处理链接项；如果程序还会自行拼接路径或打开其他路径，仍需单独设计访问边界。