登录
首页 >  Golang >  Go教程

Golang获取文件信息:os.Stat与FileInfo详解

时间:2026-02-21 08:19:41 179浏览 收藏

在Go语言开发中,高效获取文件元数据是日常操作的基础技能,本文深入解析了os.Stat与os.Lstat的核心用法及关键差异:前者通过返回实现os.FileInfo接口的只读快照,让你无需打开文件即可安全读取名称、大小、权限、修改时间等关键信息,并强调必须调用IsDir()或结合Mode()位运算来准确区分文件类型、判断符号链接、验证执行权限等;而os.Lstat则专为处理符号链接设计,能真实反映链接本身而非目标文件的属性——掌握这些细节,不仅能避免常见陷阱,还能写出更健壮、跨平台兼容的文件系统操作代码。

如何在Golang中获取文件信息_使用os Stat和FileInfo接口

在 Go 中获取文件信息,最常用的方式是调用 os.Stat 函数,它返回一个实现了 os.FileInfo 接口的值。这个接口封装了文件的基本元数据,比如名称、大小、权限、修改时间等,无需打开文件即可获取。

调用 os.Stat 获取 FileInfo

os.Stat 接收一个文件路径(字符串),返回 os.FileInfo 和可能的错误:

  • 如果路径不存在、无访问权限或不是有效路径,会返回非 nil 错误
  • 成功时返回的 FileInfo 是只读快照,不随文件后续变化而更新
  • 注意:它不区分文件和目录——需通过 IsDir() 方法判断类型

示例:

```go
info, err := os.Stat("example.txt")
if err != nil {
  log.Fatal(err)
}
fmt.Println("Name:", info.Name())
fmt.Println("Size:", info.Size(), "bytes")
fmt.Println("IsDir:", info.IsDir())
```

FileInfo 接口提供的核心方法

os.FileInfo 是一个接口,定义了以下常用方法:

  • Name():返回文件名(不含路径)
  • Size():返回文件字节数(对目录,是底层实现相关值,不应依赖)
  • Mode():返回文件权限和模式位(如 os.ModeDiros.ModePerm),可用位运算判断
  • ModTime():返回最后修改时间(time.Time 类型)
  • IsDir():快捷判断是否为目录(等价于 Mode().IsDir()
  • Sys():返回底层操作系统特定的扩展信息(如 *syscall.Stat_t),一般不用,调试或高级场景才涉及

检查文件权限与类型的小技巧

利用 Mode() 可以做细粒度判断:

  • 判断是否可执行:info.Mode()&0111 != 0(Unix-like 系统)
  • 判断是否是符号链接:info.Mode()&os.ModeSymlink != 0
  • 判断是否是普通文件:!info.IsDir() && info.Mode()&os.ModeType == 0
  • 获取八进制权限字符串:fmt.Sprintf("%o", info.Mode().Perm())

os.Lstat 与 os.Stat 的区别

如果路径可能是符号链接,要注意:

  • os.Stat:跟随符号链接,返回目标文件的信息
  • os.Lstat:不跟随符号链接,返回链接本身的信息(可用于判断是否为链接)

例如检查是否为符号链接本身,应使用 os.Lstat 并判断 Mode() & os.ModeSymlink

以上就是《Golang获取文件信息:os.Stat与FileInfo详解》的详细内容,更多关于的资料请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>