Go io/fs FileInfo.ModeDir 的目录类型判断

在 io/fs 里判断一个路径是不是目录，核心不是比较权限字符串，而是读取 fs.FileInfo.Mode() 返回的 fs.FileMode。最常用的写法是 info.IsDir()；如果需要表达底层规则，也可以判断 info.Mode()&fs.ModeDir != 0。两种写法针对目录的结论一致，后者直接展示了 ModeDir 类型位的含义。

只要已经拿到非空的 fs.FileInfo，判断目录应优先使用 IsDir()；只有在解释文件类型位、做兼容封装或调试模式值时，才直接使用 ModeDir。

官方地址：https://pkg.go.dev/io/fs

ModeDir 判断的对象到底是什么

fs.FileInfo 是文件系统返回的一份信息视图，包含名称、大小、修改时间、模式和系统数据。Mode() 返回的不是单一权限数字，而是由类型位和权限位组成的 fs.FileMode。其中 fs.ModeDir 表示目录，官方定义的 FileMode.IsDir() 正是检查这一位是否被设置。

因此，下面两种判断表达的是同一个目录类型规则：

package main

import "io/fs"

func isDirectory(info fs.FileInfo) bool {
	// IsDir 直接表达业务意图，避免调用方关心类型位的具体组合。
	return info != nil && info.IsDir()
}

func isDirectoryByMode(info fs.FileInfo) bool {
	// ModeDir 是类型位；按位与只保留目录这一位，再判断是否非零。
	return info != nil && info.Mode()&fs.ModeDir != 0
}

实际业务通常选择第一个函数。第二个函数适合写文件系统适配层、解释日志中的模式值，或者需要明确区分“类型位”和“权限位”的场景。不要把 ModeDir 和 ModePerm 混在一起：前者说明对象类型，后者才是 Unix 风格的读写执行权限。

先处理 Stat 的错误，再读取 FileInfo

目录判断的输入来自 fs.Stat、文件对象的 Stat，或者 DirEntry.Info。这些调用都可能同时返回信息和错误，所以不能忽略错误，也不能在信息为空时直接调用 Mode()。

package main

import (
	"fmt"
	"io/fs"
)

func classify(fsys fs.FS, name string) (string, error) {
	info, err := fs.Stat(fsys, name)
	if err != nil {
		// 路径不存在、没有权限等情况应保留原始错误给上层处理。
		return "", fmt.Errorf("stat %q: %w", name, err)
	}

	// Stat 成功后再读取模式，IsDir 会根据 ModeDir 返回目录结论。
	if info.IsDir() {
		return "directory", nil
	}
	return "non-directory", nil
}

这里的判断只回答“返回对象是不是目录”。它不会替调用方完成打开、遍历或创建目录，也不会把路径不存在解释成普通文件。把错误和类型结果分开返回，调用者才可以分别决定重试、跳过还是报错。

DirEntry.IsDir、Stat 与 Lstat 怎么选

如果代码已经在 fs.ReadDir 或 fs.WalkDir 回调里拿到 fs.DirEntry，优先调用 d.IsDir()。它不需要额外获取完整的 FileInfo，适合先做目录分支判断。只有需要大小、修改时间或完整模式时，才调用 d.Info()。

fs.Stat 用于获取路径对象的常规信息；在支持符号链接语义的文件系统中，它通常关注链接指向的对象。需要判断“链接本身是不是目录类型”时，应使用 fs.Lstat，并注意不同文件系统实现对链接能力的支持范围。

package main

import "io/fs"

func entryIsDirectory(entry fs.DirEntry) bool {
	// 目录遍历已有 DirEntry 时，先用轻量的 IsDir 做分支。
	return entry != nil && entry.IsDir()
}

func linkItselfIsDirectory(fsys fs.FS, name string) (bool, error) {
	info, err := fs.Lstat(fsys, name)
	if err != nil {
		// 不支持链接信息或路径异常时，把错误交给调用方判断。
		return false, err
	}
	// Lstat 关注链接自身；是否跟随链接不能靠 ModeDir 猜测。
	return info.IsDir(), nil
}

选择可以压缩成一句话：已有目录项就看 DirEntry.IsDir，需要路径的常规文件信息就用 fs.Stat，需要保留符号链接自身语义才考虑 fs.Lstat。不要先把 FileMode 格式化成字符串，再通过字符串首字符判断目录，这会丢失类型位的明确语义。

一个可复用的目录判断边界

如果多个调用点都要把路径分类，可以把“读取信息”和“判断类型”封装在一起，让错误不会被误当成非目录：

package main

import "io/fs"

func isDirPath(fsys fs.FS, name string) (bool, error) {
	info, err := fs.Stat(fsys, name)
	if err != nil {
		// false 只表示成功读取后确认不是目录；错误不能吞掉。
		return false, err
	}
	return info.Mode()&fs.ModeDir != 0, nil
}

速查表如下：

常见问题

ModeDir 是不是一个目录权限值？

不是。它是 fs.FileMode 的类型位，用来表示目录；权限应通过 ModePerm 和相关权限位解释。

为什么不直接比较 Mode 的整数值？

因为模式还可能包含符号链接、设备、管道和权限等其他位。按位检查 ModeDir 或调用 IsDir() 才不会因为附加位变化而误判。