Go fs.FileInfo.Mode 怎样识别目录和符号链接

在 Go 里扫描目录时，最容易混淆的不是“有没有这个文件”，而是拿到 fs.FileInfo 后到底该看哪个字段：目录用 IsDir()，普通文件用 IsRegular()，符号链接则要检查 Mode()&fs.ModeSymlink。如果还要判断链接本身还是链接目标，调用入口也要在 os.Stat 和 os.Lstat 之间做选择。

实用的判断顺序是：先处理错误，再判断符号链接，再判断目录，最后把剩余的常规对象按普通文件处理。不要只用文件名后缀，也不要把 FileMode.Type() 当成完整类型分类器。

先把 FileInfo 看成一组元数据

fs.FileInfo 是文件系统条目的元数据接口，常见信息包括名称、大小、权限模式、修改时间和目录判断。真正承担类型信息的是 Mode() 返回的 fs.FileMode：它同时包含权限位和一组类型位。

package main

import (
    "fmt"
    "io/fs"
)

// describeInfo 只解释已经拿到的元数据，不再次访问文件系统。
func describeInfo(info fs.FileInfo) string {
    if info == nil {
        // nil 不是一种文件类型，调用方应先处理上游错误。
        return "unknown"
    }
    mode := info.Mode()
    return fmt.Sprintf("name=%s size=%d mode=%s dir=%t regular=%t type=%s",
        info.Name(), info.Size(), mode, info.IsDir(), mode.IsRegular(), mode.Type())
}

这里把“读取元数据”和“解释模式”拆开，后面的 os.Stat 与 os.Lstat 都可以复用同一个分类函数。

目录和普通文件用便捷方法判断

对常规目录扫描来说，IsDir() 和 IsRegular() 是最清楚的表达。前者判断目录类型位，后者判断没有额外类型位的普通文件。权限位不会改变这两个方法的含义，所以不要自己截取低位再比较。

func classifyMode(mode fs.FileMode) string {
    // 类型位组合值要先单独处理符号链接。
    if mode&fs.ModeSymlink != 0 {
        return "symlink"
    }
    // 目录使用标准便捷判断，避免手工位运算。
    if mode.IsDir() {
        return "directory"
    }
    // 没有其他类型位时，IsRegular 才表示普通文件。
    if mode.IsRegular() {
        return "regular"
    }
    // 管道、设备或套接字等对象交给上层策略决定。
    return "other"
}

这个顺序让目录、普通文件和特殊对象的边界都可见。以后增加设备文件或命名管道策略时，也不会把符号链接悄悄混进“其他”分支。

符号链接要看 ModeSymlink

fs.ModeSymlink 是 FileMode 的类型位。判断它时使用按位与，而不是和整个 FileMode 做相等比较，因为模式值还可能同时带有权限位或其他信息。

func classifyInfo(info fs.FileInfo) string {
    if info == nil {
        // 没有元数据时不猜测类型，避免把错误当成普通文件。
        return "unknown"
    }
    mode := info.Mode()
    if mode&fs.ModeSymlink != 0 {
        return "symlink"
    }
    if mode.IsDir() {
        return "directory"
    }
    if mode.IsRegular() {
        return "regular"
    }
    return "other"
}

如果逻辑只是“读取目标内容”，链接通常可以跟随；如果逻辑是“清点条目、限制目录边界或显示链接本身”，就必须先明确观察对象，否则同一路径会在不同入口得到不同分类。

Stat 和 Lstat 决定你观察谁

os.Stat 会沿着符号链接查看目标，os.Lstat 则返回链接本身的元数据。两者都会返回 FileInfo，所以后续分类函数不变，变化只发生在取元数据的入口。

package main

import (
    "fmt"
    "io/fs"
    "os"
)

func inspect(path string, keepLink bool) (string, error) {
    var (
        info fs.FileInfo
        err  error
    )
    if keepLink {
        // Lstat 观察链接条目本身，适合清点和边界策略。
        info, err = os.Lstat(path)
    } else {
        // Stat 观察链接目标，适合读取目标属性。
        info, err = os.Stat(path)
    }
    if err != nil {
        // 保留原始路径错误，让上层区分不存在和权限不足。
        return "", fmt.Errorf("inspect %q: %w", path, err)
    }
    return classifyInfo(info), nil
}

真实项目中可以把布尔参数改成含义更明确的函数名，例如 classifyEntry 表示清点条目，classifyTarget 表示读取目标。调用方应该能从入口名称看出是否会跟随链接。

把判断封装成稳定的工作流

目录扫描通常按这个顺序组织：拿元数据、处理错误、识别链接、处理目录、处理普通文件、记录其他类型。这个顺序同时适合 os.FileInfo 和 io/fs 接口返回的元数据。

不要把扩展名当作类型判断，也不要用 mode == fs.ModeDir 做等值比较。前者只反映命名习惯，后者忽略组合信息。对于清理或归档任务，还要额外决定是否允许跟随链接、是否限制相对路径，以及链接目标不存在时是跳过还是报错。

常见问题

为什么 IsRegular 返回 false？

它可能是目录、符号链接、设备、管道或其他特殊文件。先检查 ModeSymlink，再根据 Type() 和业务策略处理剩余类型。

能不能只用 Type() 判断目录？

目录应优先使用 IsDir()。Type() 适合查看类型位集合，不适合替代所有便捷判断。

Stat 和 Lstat 哪个更安全？

没有脱离场景的“更安全”。清点和边界检查通常需要看到链接本身，读取目标属性才选择 Stat；关键是让调用入口和业务意图一致。

记住三点即可：FileInfo 是元数据，Mode() 提供类型位，Stat/Lstat 决定观察目标还是链接本身。把这三层分开，目录扫描中的误分类就容易定位和修正。