Go语言如何获取文件大小与权限_文件属性读取方法

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),高位存文件类型(ModeDirModeSymlink 等)。直接打印 fi.Mode() 只会输出数字,需用位运算或内置方法解读。

  • 判断是否为目录:fi.Mode().IsDir()
  • 判断是否可执行:fi.Mode().Perm()&0111 != 0Perm() 提取权限位,0111 是八进制的执行位掩码)
  • 判断是否普通文件:fi.Mode().IsRegular()
  • 获取八进制权限字符串(如 "0644"):fmt.Sprintf("%o", fi.Mode().Perm())

Windows 下权限字段基本无效,别依赖 Mode() 做访问控制

Windows 没有 Unix 风格的 rwx 位,os.FileMode 在 Windows 上只保留部分语义(如 ModeDirModeReadOnly),Perm() 返回值恒为 04440666,不代表真实 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 强转就可能截断。

  • 始终用 int64 接收 fi.Size(),避免隐式转换
  • 在做偏移量计算、buffer 分配时,确认所有中间变量也是 int64 类型
  • 对超大文件(>100GB),建议用 io.CopyN 或分段 ReadAt,而非一次性加载到内存
实际用的时候,os.Stat 是起点,但别把它当“权限检查函数”——它告诉你“当前元数据长什么样”,不保证下一毫秒还能读。真正要操作文件,该 Open 还得 Open,该 os.IsPermission 判断还得判断。