Golang获取文件大小与属性方法

本文深入解析了Go语言中获取文件大小与属性的核心方法（如os.Stat、os.ReadDir、FileInfo.Size和ModTime），揭示了看似简单的API背后隐藏的系统差异与常见陷阱：os.Stat虽轻量却需用os.IsNotExist精准判断文件存在性，Size()返回的是逻辑长度而非磁盘占用，os.ReadDir高效但DirEntry.Info()仍触发系统调用，而ModTime()的精度则严重依赖底层文件系统（如FAT32仅支持2秒粒度）。文章直击生产环境痛点——跨平台部署时权限、符号链接、压缩卷、稀疏文件及NFS异常带来的意外行为，强调开发者必须理解这些“不透明”的系统细节，才能写出健壮、高效且可移植的文件操作代码。

os.Stat 返回 *os.FileInfo 但不打开文件

调用 os.Stat 是获取文件大小、权限、修改时间等元信息最轻量的方式，它只读取目录项或 inode，不打开文件句柄，也不会触发 I/O（除非文件系统特殊）。适合批量检查、判断存在性或预估处理成本。

常见错误是误以为 os.Stat 会失败就代表文件不存在——其实它也可能因权限不足（如对父目录无执行权限）、路径是损坏符号链接、或 NFS 挂载异常而返回 os.ErrPermission 或 &os.PathError{Op: "stat"}，不能直接等价于“文件不存在”。

• 用 os.IsNotExist(err) 判断是否真不存在，而不是直接检查 err != nil
• 如果后续还要读文件，别重复调用 os.Stat + os.Open，考虑用 os.Open 后调 file.Stat() 复用句柄
• 注意：Windows 下硬链接、重解析点可能让 os.Stat 和 os.Lstat 行为不同；需跟随符号链接时用 os.Stat，否则用 os.Lstat

FileInfo.Size() 返回 int64，不是字节数的“估算”

FileInfo.Size() 是精确值，对应文件的逻辑长度（st_size），对普通文件就是字节数；对设备文件、管道、socket 等可能为 0；对稀疏文件则不含空洞字节。它不等于磁盘占用（blocks × blocksize），也不受压缩文件系统影响。

容易踩的坑是把它当成“磁盘占用”，结果在 ZFS/Btrfs 压缩卷或 NTFS 压缩文件上发现实际写入空间远小于 Size() 返回值。

• 需要真实磁盘用量？Go 标准库不提供跨平台接口，Linux 可用 syscall.Stat_t.Blocks 乘以 512，但需 cgo 或 exec du
• 读取前校验大小？别只靠 Size() 防止 OOM——某些文件（如 /proc/kcore）报告极大 size 却无法全读，应配合流式读取 + 限长
• 注意：Size() 对目录也返回 0（POSIX 行为），不能用它判断目录是否为空

os.ReadDir 比 filepath.Walk 更快，但不递归

如果你只要当前目录下文件名和基础属性（名字、是否是目录、修改时间、大小），os.ReadDir 比 filepath.Walk 快 2–5 倍，因为它一次系统调用读取整个目录，且默认不解析 symlink 目标（避免 stat 开销）。

但它返回的是 fs.DirEntry，不是 os.FileInfo：只有 Name()、IsDir()、Type() 是免 stat 的，Info() 才真正触发系统调用。很多人误以为 DirEntry.Info().Size() 是零成本。

• 只过滤文件名或类型？直接用 entry.IsDir()，别调 entry.Info()
• 需要大小/时间？批量调 entry.Info() 仍比逐个 os.Stat 稍快（内核可能缓存），但不如提前规划好字段需求
• 要递归？别硬套 os.ReadDir 自己实现栈，用 filepath.WalkDir（Go 1.16+），它支持跳过子树且能复用 DirEntry

time.Time.ModTime() 的纳秒精度在 FAT32 上会降级

FileInfo.ModTime() 返回 time.Time，理论上纳秒精度，但底层文件系统可能不支持。FAT32 只记录 2 秒粒度的修改时间，exFAT 是 10ms，ext4/XFS 通常支持纳秒——Go 不做补偿，直接暴露内核返回值。

这意味着：在 Windows U 盘（FAT32）上，两个间隔 1 秒内修改的文件，ModTime() 可能完全相同；用它做“是否更新”的判断会出错。

• 需要高精度比较？优先用文件内容 hash 或 FileInfo.Sys() 提取原始 syscall.Stat_t 中的 Atim/Nsec 字段（需判断 OS 和 fs）
• 做缓存失效？别单靠 ModTime()，加一个简单内容 checksum（如前 64 字节 CRC32）更稳
• 注意：ModTime() 是本地时区时间，但序列化到 JSON 时会转为 UTC；跨时区服务传时间戳需显式用 .UTC() 或 .UnixNano()

文件属性看似简单，但 size 是否含空洞、mtime 是否可信、stat 是否真轻量，都取决于操作系统和文件系统行为。别假设标准库会帮你抹平差异——尤其是部署到混合环境（Linux + Windows + NAS）时，每个 os.Stat 调用背后都可能藏着一个 syscall 和一次权限检查。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~