17370845950

os.Stat是最轻量的文件元信息获取方式，但FileInfo不存路径、不解链接，需先判err再调IsDir，用Lstat查软链自身，Readlink获目标路径，Name()仅返回文件名而非全路径。

直接说结论：os.Stat 是获取文件元信息最常用、最轻量的方式，但它的返回值 os.FileInfo 接口本身不提供路径或符号链接解析能力，很多看似“理所当然”的需求（比如判断是否为绝对路径、是否是软链目标、是否在某个目录下）需要额外处理。

os.Stat 返回的 FileInfo 为什么不能直接用 IsDir() 判断目录存在？

os.Stat 在路径不存在时会返回错误，nil 的 os.FileInfo；只有成功时才返回有效接口。所以不能先调 IsDir

• 正确做法是先检查 err 是否为 nil，再用 fi.IsDir()
• os.IsNotExist(err) 比 err != nil 更安全，能区分“不存在”和“权限不足”等其他错误
• fi.Mode() 返回的 os.FileMode 是位掩码，fi.Mode().IsDir() 和 fi.IsDir() 等价，但前者可组合其他位判断（如 fi.Mode()&os.ModeSymlink != 0）

想获取真实路径（解符号链接）该用 Stat 还是 Lstat？

用 os.Lstat 获取符号链接本身的信息，用 os.Stat 获取它指向的目标信息。两者返回的 os.FileInfo 类型一致，但语义不同。

• 如果路径是软链：os.Stat 返回目标文件的 FileInfo（若目标不存在则报 os.ErrNotExist）
• os.Lstat 总是返回软链自身的元信息，fi.Mode()&os.ModeSymlink != 0 可确认它是软链
• 要获取软链指向的路径字符串，得用 os.Readlink(path)，FileInfo 不含该字段

FileInfo.Name() 返回的是文件名，不是完整路径

这是最容易踩的坑：fi.Name() 只返回路径末尾的名称（不含任何目录），哪怕你传入的是 /usr/local/bin/go，它也只返回 "go"。

• 要提取目录名，用 filepath.Dir(path)；要提取文件名，用 filepath.Base(path)（二者行为与 fi.Name() 不同）
• fi.Name() 实际上等价于 filepath.Base(path)，但仅当 path 是合法路径时；若 path 含非法字符或为空，Stat 会失败，fi 为 nil
• 没有 API 能从 FileInfo 反推原始路径——它不保存路径，只保存内核返回的元数据

性能与并发场景下的注意事项

os.Stat 是系统调用，开销虽小但不可忽略；高频调用（如遍历大目录）时，重复调用 Stat 多次同一路径是典型浪费。

• 一次 os.Stat 足够获取大小、修改时间、权限、类型等全部基础信息，无需拆成 Size()、ModTime() 单独查
• 在 filepath.WalkDir 或 io/fs.WalkDir 中，回调函数参数已含 fs.DirEntry，其 Info() 方法才需触发系统调用；若只需名称和类型，用 entry.Type() 避免额外 Stat
• 并发调用 Stat 没有锁问题，但要注意文件可能被外部进程删改，err 可能是 os.ErrNotExist 或 syscall.EACCES，需按实际场景处理

path := "/etc/hosts"
fi, err := os.Stat(path)
if err != nil {
    if os.IsNotExist(err) {
        fmt.Println("文件不存在")
    } else {
        fmt.Printf("访问失败：%v", err)
    }
    return
}
fmt.Printf("文件名：%s\n", fi.Name())           // "hosts"
fmt.Printf("大小：%d 字节\n", fi.Size())
fmt.Printf("是否为目录：%t\n", fi.IsDir())
fmt.Printf("权限：%s\n", fi.Mode().String())

真正容易被忽略的是：所有这些操作都依赖操作系统返回的底层 stat 结构，而不同平台对 nanosecond 级时间戳、扩展属性、硬链接计数等支持不一；跨平台工具里别假设 fi.Sys() 返回的类型或字段一定可用。