最常用字段是size()、mode()、modtime():size()返回字节大小,mode()返回含类型与权限的filemode(需perm()提取权限位),modtime()返回纳秒精度time.time。

os.Stat 返回的 FileInfo 里哪些字段最常用
Go 里查文件元数据,os.Stat 是绕不开的入口。它返回一个 os.FileInfo 接口,实际通常是 os.fileStat(内部结构体),但你只管用接口方法就行。
最常取的三个字段:大小、权限、修改时间——它们分别对应 Size()、Mode()、ModTime()。注意:Mode() 返回的是 os.FileMode,不是字符串,要转成八进制或符号表示得自己处理;ModTime() 是 time.Time,直接格式化即可。
-
Size()单位是字节,对普通文件可靠;对设备文件、管道等可能返回 0 -
Mode()包含权限 + 文件类型(比如是否是目录、符号链接),判断目录要用fi.Mode().IsDir(),别直接比对os.ModeDir -
ModTime()是纳秒精度,但底层文件系统可能只支持秒级(如 FAT32),所以两次调用可能看起来“没变”
os.Lstat 和 os.Stat 的区别在哪
遇到符号链接时行为完全不同:os.Stat 会自动解引用,返回目标文件的元数据;os.Lstat 则停在链接本身,返回链接文件自己的信息(比如链接文件的大小、创建时间、权限)。
典型误用场景:想检查某个路径是不是符号链接,却用了 os.Stat ——结果它一路跳转到目标,Mode().IsSymlink() 永远返回 false。
立即学习“go语言免费学习笔记(深入)”;
- 要判断路径本身是不是软链,必须用
os.Lstat+fi.Mode().IsSymlink() - 读取软链指向的目标路径,用
os.Readlink(path),不是从FileInfo里拿 - Windows 下符号链接支持有限,
os.Lstat在某些旧版本 NTFS 上可能返回不完整信息
获取权限时为什么 0644 变成 -rw-r--r-- 不一致
os.FileMode 的底层值确实是整数(比如 0644),但它实现了 String() 方法,打印时默认输出符号形式(-rw-r--r--)。这容易让人误以为“值变了”,其实只是显示逻辑不同。
真正要注意的是:权限位里的 setuid/setgid/sticky 位(如 04755)在 Mode() 中是保留的,但 os.Chmod 默认不修改这些位,除非显式传入完整掩码。
- 要严格比对权限数字,用
fi.Mode().Perm() & 0777提取用户/组/其他三段权限 - 直接
fmt.Printf("%o", fi.Mode())会打出带类型位的八进制(如100644表示普通文件 + 0644),别漏掉高位 - Linux 上 umask 会影响新建文件权限,但不影响
os.Stat读出的已有文件权限
小文件频繁 stat 的性能隐患
每次 os.Stat 都是一次系统调用,走内核路径查找 + inode 读取。在循环里反复查同一文件,或者遍历大目录时对每个文件都 Stat,很容易成为瓶颈。
尤其在 NFS 或某些容器挂载场景下,单次 stat 延迟可能高达毫秒级,叠加后明显拖慢程序。
- 能缓存就缓存:如果文件内容不变,元数据短期内大概率也不变,把
os.FileInfo结构体存起来复用 - 批量操作优先用
filepath.WalkDir(Go 1.16+),它在遍历时可直接拿到fs.DirEntry,用DirEntry.Info()按需加载,避免为每个文件都触发完整stat - 只关心是否存在?用
os.Stat看错误是否为os.IsNotExist(err)就够了,别顺手取Size()——多一次字段解析不必要
文件元数据看着简单,但权限位组合、符号链接跳转、系统调用开销这几个点,稍不注意就会在边界场景里冒出来。尤其是混合使用 Stat/Lstat 和 Readlink 时,路径语义容易串。










