Go io/fs FileMode 怎样判断文件是目录还是普通文件

在 Go 里判断一个路径是不是目录，最稳妥的入口不是猜权限字符串，也不是直接比较某个十六进制值，而是读取 io/fs.FileMode 后调用 IsDir()。如果还要区分普通文件、符号链接或其他特殊类型，再配合 IsRegular()、Type() 和 Perm()。

官方文档：https://pkg.go.dev/io/fs#FileMode

这几个方法解决的是“类型判断”和“权限读取”两个不同问题。下面按实际排查路径拆开，避免把权限位误当成目录标志。

先确认 FileMode 来自哪里

FileMode 常见于两种对象。通过 fs.Stat、fs.FileInfo 得到的是完整的文件信息；通过 fs.ReadDir 或 fs.WalkDir 得到的 fs.DirEntry，可以先用 IsDir() 和 Type() 做轻量判断，需要完整信息时再调用 Info()。

这意味着遍历时不必为了判断目录就立刻打开或统计每个路径。若回调已经拿到了 DirEntry，先使用它提供的类型信息；只有需要大小、修改时间或更完整的模式数据时，再请求 Info()。

用 IsDir 和 IsRegular 做主判断

IsDir() 检查的是 ModeDir 位；IsRegular() 检查的是没有设置类型位。两者比读取 String() 的首字符或手写掩码更直接：

package main

import (
    "fmt"
    "io/fs"
)

func describe(info fs.FileInfo) string {
    mode := info.Mode()

    // 目录判断只看 ModeDir，不把 0755 等权限位混进来。
    if mode.IsDir() {
        return "目录"
    }

    // 没有任何类型位时，FileMode 才表示普通文件。
    if mode.IsRegular() {
        return "普通文件"
    }

    // 其余情况可能是符号链接、设备、管道或其他特殊文件。
    return fmt.Sprintf("其他类型（%s）", mode.Type())
}

示例的关键点是先判断目录，再判断普通文件。特殊文件不应该被笼统地当作普通文件处理，因为后续读取、复制或打开策略可能不同。

需要细分类型时读取 Type 和 Perm

Type() 返回类型位的集合，Perm() 只返回低位的 Unix 权限。两者的职责完全不同：

func modeSummary(mode fs.FileMode) (string, fs.FileMode) {
    // Type 只保留目录、符号链接、管道等类型信息。
    fileType := mode.Type()

    // Perm 只保留 rwxrwxrwx 权限位，不能用它判断是否为目录。
    permission := mode.Perm()
    return fileType.String(), permission
}

例如，目录可能同时拥有目录类型位和 0755 权限；普通文件也可能拥有 0644 权限。权限数字相同并不能说明对象类型相同。符号链接还要特别注意统计方式：调用 Stat 往往得到目标对象的信息，而 Lstat 才用于保留链接本身的描述。

把判断放进遍历和错误处理

在 fs.WalkDir 里，目录判断通常直接使用回调的 DirEntry.IsDir()。如果读取条目信息失败，应保留当前路径和原始错误，不要把失败路径伪装成普通文件：

func visit(fsys fs.FS, root string) error {
    // WalkDir 的回调直接获得相对路径与目录项，适合先做类型分流。
    return fs.WalkDir(fsys, root, func(path string, entry fs.DirEntry, err error) error {
        if err != nil {
            // 保留遍历位置和底层错误，调用方才能决定是否跳过。
            return fmt.Errorf("读取 %s: %w", path, err)
        }

        if entry.IsDir() {
            // 目录只负责继续遍历，不把它送入普通文件处理器。
            return nil
        }

        if entry.Type().IsRegular() {
            // 普通文件可以进入读取、索引或归档分支。
            return handleRegular(path)
        }

        // 符号链接和其他类型由业务策略单独决定。
        return nil
    })
}

如果业务需要完整的 FileInfo，在回调中调用 entry.Info() 并处理它的错误。这样可以把“访问失败”和“对象本来就是特殊类型”区分开，日志也更容易定位。

几个容易混淆的结论

• 不要用权限判断目录：Perm() 只看权限位，目录和文件都可能是 0755。
• 不要把 Type 当成完整模式：Type() 不包含普通权限位，需要权限时单独调用 Perm()。
• 不要把特殊类型当普通文件：IsRegular() 返回 false 时，应由业务决定是否跳过、跟随或报错。
• 不要吞掉遍历错误：错误回调中的路径是定位问题的重要上下文，至少用 %w 保留原始错误。

相关问题

FileMode 的目录判断需要自己与 ModeDir 做位运算吗？不需要，优先使用 IsDir()，它表达的意图更清晰，也避免把类型位布局写死在业务代码里。

为什么 DirEntry 没有完整权限信息？DirEntry 适合目录读取阶段的轻量信息；需要完整模式、大小或时间时，再调用 Info() 获取 FileInfo。

普通文件的 Type 为什么是零？因为 IsRegular() 的定义就是没有设置任何类型位；零类型位并不代表权限为零。