os.Stat 是读取文件大小和修改时间的最高效方式,返回 FileInfo 接口提供 Size() 和 ModTime() 方法;ModTime() 返回本地时区时间,非 UTC;Size() 对目录、设备文件等语义特殊,不可用于判空;批量操作应避免重复调用。

用 os.Stat 一次性读取文件大小和修改时间
Go 中不推荐分别调用多个函数查大小和时间,os.Stat 是最直接、最高效的方式。它返回一个 os.FileInfo 接口,其中就包含 Size() 和 ModTime() 方法。
-
os.Stat不打开文件,只读取元数据,开销极小 - 如果路径是符号链接,默认解析目标文件(如需读链接本身,用
os.Lstat) - 失败时返回
*os.PathError,常见错误包括no such file or directory或权限不足
info, err := os.Stat("config.json")
if err != nil {
log.Fatal(err) // 例如:stat config.json: no such file or directory
}
size := info.Size() // int64,单位字节
modTime := info.ModTime() // time.Time
ModTime() 返回的是本地时区时间,不是 UTC
很多人误以为 ModTime() 是 UTC 时间,其实它保留了系统记录的原始时钟值,并以本地时区显示 —— 这由底层 stat 系统调用决定,Go 不做转换。
- 打印时会自动按本地时区格式化,比如
2024-05-12 14:30:22.123 +0800 CST - 如需 UTC,显式调用
.UTC();如需 Unix 时间戳,用.Unix()或.UnixMilli() - 跨时区比较时间时,务必统一时区(建议转为 UTC 再比)
注意 Size() 对目录和设备文件的含义
Size() 在不同文件类型下语义不同,不是所有情况都返回“内容长度”:
- 普通文件:返回实际字节数(可靠)
- 目录:返回该目录在文件系统中占用的“目录项结构”大小(Linux 下通常是 4096 或 8192,与子项数量无关)
- 设备文件(如
/dev/sda)、管道、套接字:返回 0 —— 不代表没数据,只是内核不提供有意义的 size - 不能用
Size() == 0判断空文件,应结合IsDir()和实际读取逻辑
批量读取时避免重复调用 os.Stat
循环处理多个文件时,别在每次判断大小或时间前都调一次 os.Stat —— 它是系统调用,有明显开销。尤其在 NFS 或远程文件系统上延迟更明显。
- 先用
filepath.WalkDir或os.ReadDir获取fs.DirEntry,它自带Size()和基础时间信息(但不含完整ModTime) - 需要精确
ModTime时,对筛选后的少量文件再调os.Stat - 若已打开文件,可用
file.Stat()替代os.Stat(path),省一次路径查找
真正容易被忽略的是:ModTime() 的精度取决于文件系统。ext4 默认是秒级,XFS 可达纳秒,但 Windows NTFS 在 FAT 兼容模式下可能只有 2 秒精度 —— 别假设它总能区分毫秒级改动。










