Go os.File.Stat 怎样判断打开对象是目录还是普通文件

在 Go 里，判断一个已经打开的对象是目录还是普通文件，应该读取 os.File.Stat() 返回的 FileInfo，而不是根据路径后缀或文件名猜测。最小判断链路是：打开对象、处理打开错误、调用 Stat、检查 Mode().IsDir() 或 Mode().IsRegular()，最后关闭文件句柄。

官方地址：https://pkg.go.dev/os#File.Stat

本文只讨论打开对象的类型判断、错误分支和资源关闭，不展开目录遍历或路径规范化。

先明确 Stat 返回的是什么

File.Stat 返回 FileInfo 和 error。成功时，FileInfo 描述当前打开对象；失败时要先处理错误，不能继续访问空的元数据。官方文档说明，这类错误通常是 *PathError，可以继续用 errors.Is 判断底层原因。

package main

import (
    "fmt"
    "os"
)

func inspect(path string) error {
    // Open 只负责取得句柄；失败时不要继续调用 Stat。
    file, err := os.Open(path)
    if err != nil {
        return fmt.Errorf("打开 %q 失败: %w", path, err)
    }
    // 句柄由当前函数获得，因此在返回前统一关闭。
    defer file.Close()

    info, err := file.Stat()
    if err != nil {
        return fmt.Errorf("读取 %q 元数据失败: %w", path, err)
    }
    fmt.Printf("name=%s dir=%t regular=%t size=%d\\n",
        info.Name(), info.IsDir(), info.Mode().IsRegular(), info.Size())
    return nil
}

这里的关键是把 Open 和 Stat 分成两个错误边界。路径不存在、权限不足或句柄状态异常，都应该在对应调用点返回，而不是把错误延迟到后面的类型判断。

用 FileInfo 的模式位判断目录和普通文件

目录判断使用 info.IsDir()，普通文件判断使用 info.Mode().IsRegular()。二者都为假时，不要强行归为普通文件，因为符号链接、设备文件或其它特殊类型可能需要单独处理。

package main

import (
    "fmt"
    "os"
)

func kindOf(path string) (string, error) {
    // 通过句柄获取对象信息，避免只看扩展名作出错误结论。
    file, err := os.Open(path)
    if err != nil {
        return "", err
    }
    // 无论分类结果是什么，都释放本函数打开的句柄。
    defer file.Close()

    info, err := file.Stat()
    if err != nil {
        return "", err
    }
    switch {
    case info.IsDir():
        return "directory", nil
    case info.Mode().IsRegular():
        return "regular-file", nil
    default:
        return fmt.Sprintf("special:%s", info.Mode().String()), nil
    }
}

Size()、ModTime() 等字段适合补充展示或业务判断，但不能替代类型判断。比如空目录的大小并不能说明它是普通文件，带有 .log 后缀的目录也仍然是目录。

从路径猜测迁移到 Stat 判断

迁移时先替换“字符串判断”这一层，再保留原有业务动作。例如目录进入遍历分支，普通文件进入读取分支，特殊文件直接返回明确结果。这样类型识别和后续操作的责任更清楚。

回归检查与使用清单

把实现接入业务前，至少准备一个目录、一个普通文件和一个不存在的路径。检查结果时关注三点：目录只进入目录分支；普通文件只进入普通文件分支；不存在的路径在 Open 阶段返回错误，并且不会继续调用 Stat。

1. 成功打开后立即安排 Close，避免异常分支泄漏句柄。
2. 先判断 Stat 错误，再访问 FileInfo。
3. 目录用 IsDir，普通文件用 IsRegular，其它类型保留独立分支。
4. 需要区分“不存在”和“无权限”时，用 errors.Is 配合 os.ErrNotExist 或 os.ErrPermission。

常见问题

为什么不能用文件扩展名判断普通文件？

扩展名只是名称的一部分，不能代表文件系统对象类型。目录可以带扩展名，普通文件也可以没有扩展名；类型应以 FileInfo.Mode() 的结果为准。

Stat 和 Lstat 在本文场景有什么区别？

本文从已打开的 *os.File 调用 Stat，描述这个打开对象。若从路径调用函数并且需要把符号链接本身与目标区分开，才需要进一步比较路径级的 Stat 和 Lstat 语义。

总结：os.File.Stat 负责取得元数据，FileInfo 负责描述对象，IsDir 与 IsRegular 负责做类型分支；错误处理和 Close 则保证这条判断链路能稳定运行。