Go fs.FileMode 类型位判断的兼容写法

Go 里判断文件类型，最稳妥的做法不是把 fs.FileMode 当成一个普通整数比较，而是使用它提供的语义方法：目录用 IsDir()，普通文件用 IsRegular()，需要区分符号链接、管道或设备时读取 Type()。权限位则单独交给 Perm()。这样写能同时适配 fs.FileInfo、fs.DirEntry 和自定义文件系统，减少平台差异带来的误判。

官方参考：https://pkg.go.dev/io/fs

先把 FileMode 的两组信息分开

FileMode 的高位描述文件类型，低九位描述常见的 Unix 权限。完整值可能同时包含两组信息，因此不要写成 mode == 0644 或依赖某个十六进制常量。下面的最小写法把目录、普通文件和权限读取拆开，调用方只关心语义。

func describeMode(mode fs.FileMode) string {
	// 先判断目录；IsDir 内部只检查 ModeDir 类型位。
	if mode.IsDir() {
		return "directory"
	}
	// 没有任何类型位时，fs 将其视为普通文件。
	if mode.IsRegular() {
		return fmt.Sprintf("regular, perm=%#o", mode.Perm())
	}
	// Type 只保留类型位，便于记录符号链接、管道等非普通类型。
	return fmt.Sprintf("special, type=%s", mode.Type())
}

这里的关键不是记住位的位置，而是让每个判断表达它真正回答的问题：是不是目录、是不是普通文件、有哪些类型位、权限是多少。官方实现也以 m&ModeDir 判断目录，以 m&ModeType == 0 判断普通文件。

FileInfo 与 DirEntry 要采用同一套边界

拿到 fs.FileInfo 时，Mode() 返回的是完整模式，直接调用 IsRegular() 是可靠的。遍历目录时常先拿到 fs.DirEntry，它提供的 IsDir() 和 Type() 适合快速筛选，但 Type() 只返回已知的类型位子集。类型位为零，可能是普通文件，也可能是当前文件系统没有提供足够信息。

func classifyEntry(entry fs.DirEntry) (string, error) {
	// 目录判断由 DirEntry 直接提供，避免先读取完整元数据。
	if entry.IsDir() {
		return "directory", nil
	}

	typeBits := entry.Type()
	if typeBits != 0 {
		// 已知非零类型位时，不把符号链接等类型当普通文件。
		return fmt.Sprintf("special: %s", typeBits), nil
	}

	// Type 为零只代表没有已知类型位，必要时回退到完整信息。
	info, err := entry.Info()
	if err != nil {
		return "unknown", fmt.Errorf("read %q info: %w", entry.Name(), err)
	}
	if info.Mode().IsRegular() {
		return "regular", nil
	}
	return fmt.Sprintf("special: %s", info.Mode().Type()), nil
}

这段封装的安全价值在于：只有经过 Info() 确认后，才把“没有类型位”归类为普通文件。对于只统计普通文件数量的轻量场景，可以接受 Type()==0 的快速路径；对于删除、执行、上传或权限检查，则建议使用回退路径。

符号链接与未知类型不能靠去掉问号解决

业务策略要先决定是否跟随符号链接。使用 fs.ReadDir 得到目录项后，Type() 可能保留 ModeSymlink；使用 Info() 时还要明确读取的是链接本身还是链接目标。不要把所有非目录项都交给上传器或递归遍历器，至少先排除 ModeSymlink，并对 ModeType 中的未知组合保留日志。

func safeRegular(mode fs.FileMode) bool {
	// 只有没有任何类型位时才接受为普通文件。
	if mode.Type() != 0 {
		return false
	}
	// 权限位不改变“是否普通文件”的结论，单独检查权限策略。
	return mode.IsRegular() && mode.Perm()&0002 == 0
}

示例里的写权限检查只是一个业务示意，不能替代完整的访问控制。若程序运行在跨平台或自定义 FS 环境中，还要考虑某些系统不支持全部类型位；代码应把无法确认的结果当成需要进一步处理的状态，而不是静默放行。

把判断结果固定成可复查的清单

兼容写法最终要服务于调用方。发布前可以按四个案例检查：真实目录应命中 IsDir()；普通文件应命中 IsRegular()；符号链接或设备文件应在 Type() 中留下类型信息；自定义 FS 返回类型位为零时，Info() 失败必须传播错误。日志记录类型名和路径即可，不要依赖完整模式整数作为长期协议字段。

如果代码只需要目录与非目录二分，优先使用 IsDir()。如果要判断是否能安全作为普通文件处理，使用 ModeType 或 IsRegular()，并为未知类型保留回退。只有在展示权限或生成权限字符串时才读取 Perm()，这样可以让类型判断在 Go 的不同文件系统实现之间保持清晰。

相关问题

mode.Perm() 能判断是不是普通文件吗？

不能。Perm() 只保留权限位，目录和普通文件都可能拥有相同的权限值。文件类型应使用 IsDir()、IsRegular() 或 Type()。

DirEntry.Type()==0 就一定是普通文件吗？

不一定。它表示没有已知类型位，普通文件只是其中一种可能；需要严谨分类时调用 Info()，并处理返回错误。