Golang文件元数据获取_查看大小、权限与修改时间

最常用字段是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 时，路径语义容易串。