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"。
立即学习“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() 返回的类型或字段一定可用。
