os.Stat 一次系统调用即可获取文件完整元数据,返回 os.FileInfo 接口,含 Size()、Mode()、ModTime() 等方法;需检查 error,符号链接默认跟随,权限解析依赖 FileMode 位运算,Windows 下权限字段无效。

用 os.Stat 一次性读取文件大小、权限等完整属性
Go 中不推荐分别调用多个函数去查大小、权限、修改时间——os.Stat 一次系统调用就能拿到全部元数据,性能好且线程安全。
-
os.Stat返回os.FileInfo接口,包含Size()、Mode()、ModTime()等方法 - 如果路径是符号链接,
os.Stat会自动跟随;需要获取链接本身信息,请用os.Lstat - 注意检查返回 error:路径不存在、无读权限、设备不可达等情况都会导致失败
fi, err := os.Stat("/path/to/file")
if err != nil {
log.Fatal(err) // 或按需处理:os.IsNotExist(err), os.IsPermission(err)
}
size := fi.Size() // int64,单位字节
mode := fi.Mode() // os.FileMode 类型
mtime := fi.ModTime() // time.Time
os.FileMode 怎么解析权限(尤其是 Linux/macOS 的 rwx)
os.FileMode 是 uint32,低 12 位存储 Unix 权限位(如 0755),高位存文件类型(ModeDir、ModeSymlink 等)。直接打印 fi.Mode() 只会输出数字,需用位运算或内置方法解读。
- 判断是否为目录:
fi.Mode().IsDir() - 判断是否可执行:
fi.Mode().Perm()&0111 != 0(Perm()提取权限位,0111是八进制的执行位掩码) - 判断是否普通文件:
fi.Mode().IsRegular() - 获取八进制权限字符串(如
"0644"):fmt.Sprintf("%o", fi.Mode().Perm())
Windows 下权限字段基本无效,别依赖 Mode() 做访问控制
Windows 没有 Unix 风格的 rwx 位,os.FileMode 在 Windows 上只保留部分语义(如 ModeDir、ModeReadOnly),Perm() 返回值恒为 0444 或 0666,不代表真实 ACL 权限。
- 若需跨平台检查「是否只读」,用
fi.Mode() & os.ModeReadOnly != 0 - 若需真实 Windows 权限(如用户/组/ACE 列表),必须调用 Win32 API(如
GetNamedSecurityInfo),Go 标准库不提供封装 - 生产环境做权限校验时,最可靠方式仍是尝试打开文件并捕获
os.IsPermission(err)
大文件 Size() 返回值是 int64,但某些旧文件系统可能溢出
绝大多数现代文件系统(ext4、NTFS、APFS)支持 >2TB 文件,int64 足够(最大约 9EB)。但极少数嵌入式或老旧系统(如 FAT32)限制单文件 ≤4GB,此时 Size() 仍返回正确值,但后续计算(如分块读取)若用 int 强转就可能截断。
立即学习“go语言免费学习笔记(深入)”;
- 始终用
int64接收fi.Size(),避免隐式转换 - 在做偏移量计算、buffer 分配时,确认所有中间变量也是
int64类型 - 对超大文件(>100GB),建议用
io.CopyN或分段ReadAt,而非一次性加载到内存
os.Stat 是起点,但别把它当“权限检查函数”——它告诉你“当前元数据长什么样”,不保证下一毫秒还能读。真正要操作文件,该 Open 还得 Open,该 os.IsPermission 判断还得判断。










