os.stat 最轻量获取文件元信息,但不保证文件存在;需用 os.isnotexist(err) 判断;fileinfo.size() 是逻辑长度非磁盘占用;os.readdir 比 filepath.walk 快但不递归;modtime() 精度依赖文件系统。

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 或 execdu - 读取前校验大小?别只靠
Size()防止 OOM——某些文件(如 /proc/kcore)报告极大 size 却无法全读,应配合流式读取 + 限长 - 注意:
Size()对目录也返回 0(POSIX 行为),不能用它判断目录是否为空
os.ReadDir 比 filepath.Walk 更快,但不递归
如果你只要当前目录下文件名和基础属性(名字、是否是目录、修改时间、大小),os.ReadDir 比 filepath.Walk 快 2–5 倍,因为它一次系统调用读取整个目录,且默认不解析 symlink 目标(避免 stat 开销)。
Go 配置库,使用 spf13/viper — 分层优先级(flag > env >file > KV > default),提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
但它返回的是 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的核心概念和高级技巧!










