获取文件大小和修改时间的Go方法

本文深入解析了 Go 语言中高效获取文件大小和修改时间的核心方法——`os.Stat`，强调其一次性读取元数据的高性能优势，并澄清了 `ModTime()` 返回本地时区时间（非 UTC）、`Size()` 在目录/设备文件中语义特殊等关键误区；同时提醒开发者避免批量操作中重复调用带来的性能损耗，注意文件系统时间精度差异，以及正确判空、跨时区比较和符号链接处理等实战细节，是 Go 文件元数据操作不可忽视的权威指南。

用 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 秒精度 —— 别假设它总能区分毫秒级改动。

好了，本文到此结束，带大家了解了《获取文件大小和修改时间的Go方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！