Go获取文件大小和修改时间教程

在 Go 中，`os.Stat` 是高效获取文件大小和修改时间的首选方法，它通过单次系统调用读取元数据，避免重复开销；但需注意 `ModTime()` 返回的是本地时区时间而非 UTC，跨时区比较务必统一转换为 UTC；`Size()` 对普通文件可靠，但对目录、设备文件等有特殊语义，不可用于空文件判断；批量操作时应结合 `filepath.WalkDir` 或 `os.ReadDir` 预筛选，再对关键文件调用 `os.Stat`，同时警惕不同文件系统下 `ModTime` 的精度差异——这些细节看似微小，却极易引发隐蔽 Bug，掌握它们才能写出健壮可靠的文件处理逻辑。

用 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学习网公众号吧！