Go中判断文件类型最可靠方式是用os.Stat()获取FileInfo并调用Mode()方法配合IsDir()、IsRegular()等方法或位运算;FileMode是uint32,高4位标识类型,低12位表示权限,不可直接当chmod数字使用。

在 Go 语言中,判断文件类型最常用、最可靠的方式是结合 os.Stat() 获取的 os.FileInfo 和其 Mode() 方法返回的 os.FileMode 值,再通过 IsDir()、IsRegular() 等方法或位运算来识别。直接依赖文件扩展名或内容(如 magic number)属于进阶场景,而本篇聚焦于系统级元数据判断——这也是日常开发中最轻量、最高效的做法。
FileMode 是什么?它不是简单的权限数字
os.FileMode 是一个 uint32 类型,但它的高 4 位(bit 28–31)用于标识文件类型(如目录、符号链接、设备文件等),低 12 位才表示传统 Unix 权限(rwx)。因此不能把它当成纯 chmod 数字来用。
Go 标准库已封装好常用判断方法,推荐优先使用:
-
fi.Mode().IsDir()—— 判断是否为目录(最常用) -
fi.Mode().IsRegular()—— 判断是否为普通文件(非目录、非设备、非管道等) -
fi.Mode()&os.ModeSymlink != 0—— 判断是否为符号链接(IsSymlink()在 Go 1.15+ 已内置) -
fi.Mode()&os.ModeNamedPipe != 0—— 判断是否为命名管道(FIFO) -
fi.Mode()&os.ModeDevice != 0—— 判断是否为设备文件(如 /dev/sda)
正确使用 os.Stat + FileMode 判断类型
注意:必须用 os.Stat()(不跟随符号链接),而不是 os.Lstat()(仅当需区分链接本身和目标时才用后者)。大多数“判断文件类型”需求应以实际元数据为准,而非链接指向。
立即学习“go语言免费学习笔记(深入)”;
示例代码:
fi, err := os.Stat("/path/to/xxx")
if err != nil {
log.Fatal(err)
}
mode := fi.Mode()
if mode.IsDir() {
fmt.Println("这是一个目录")
} else if mode.IsRegular() {
fmt.Println("这是一个普通文件")
} else if mode&os.ModeSymlink != 0 {
fmt.Println("这是一个符号链接")
} else if mode&os.ModeNamedPipe != 0 {
fmt.Println("这是一个命名管道")
} else {
fmt.Printf("其他类型:%s\n", mode.String()) // 输出如 "-rwxr-xr-x" 或 "drwxr-xr-x" 等
}
IsDir() 的常见误区与安全写法
IsDir() 返回 true 仅说明该路径对应一个目录类型的 inode,但它**不保证路径可访问或存在**。所以务必先检查 os.Stat 是否成功,否则调用 IsDir() 可能 panic(如果 fi == nil)。
更健壮的写法:
- 始终先判 err,再用 fi
- 避免对
nil的FileInfo调用任何方法 - 若需兼容不存在路径,可用
errors.Is(err, os.ErrNotExist)单独处理
错误示范:os.Stat("xxx").Mode().IsDir() —— 没有错误处理,极易崩溃。
补充:快速判断路径是否存在且为目录的惯用写法
很多场景只需知道“是不是一个存在的目录”,可以封装成一行逻辑(但内部仍走 Stat):
func IsDir(path string) bool {
fi, err := os.Stat(path)
return err == nil && fi.IsDir()
}
类似地,可写出 IsFile(path string) bool(即 err == nil && fi.Mode().IsRegular())。
注意:不要用 os.Open() + Readdir(0) 来判断目录——效率低、副作用大、且对权限敏感。
基本上就这些。FileMode 的本质是位掩码,Go 已为你屏蔽了大部分底层细节。善用 IsXXX() 方法,比手动位运算更清晰安全;结合 os.Stat 的错误处理,就能稳稳判断绝大多数文件类型场景。










