Go的os.FileInfo不提供uid/gid等系统级字段，因其跨平台设计；需通过fi.Sys()类型断言获取底层结构，但必须检查nil、按OS分支处理、使用golang.org/x/sys/unix而非已弃用的syscall包。
Go 的 os.FileInfo 接口本身不提供 uid/gid、inode、blocks 等系统级字段，这是设计使然——它要跨平台，而 Windows 根本没有 uid/gid 概念。真要读这些，必须绕过接口，用 fi.Sys() 拿底层结构，但不能硬转、不能假设类型、不能忽略 nil。
为什么 fi.Sys() 直接断言 *syscall.Stat_t 会 panic 或编译失败
Go 1.20+ 已弃用 syscall 包，syscall.Stat_t 不再导出；Linux/macOS 实际返回的是 *unix.Stat_t（来自 golang.org/x/sys/unix），Windows 返回的是 *syscall.Win32FileAttributeData，某些容器环境甚至返回 nil。
- 硬写
fi.Sys().(*syscall.Stat_t)→ 编译报错（Go 1.20+） - 不检查
fi.Sys() == nil→ 运行时 panic - 在 Windows 上断言
*unix.Stat_t→ 类型不匹配，ok为 false，但没处理就继续用 → 静默逻辑错误
如何安全获取 uid/gid（仅 Linux/macOS 有效）
uid/gid 只在 Unix-like 系统上有意义，Windows 下无对应概念，代码必须显式分支处理，且始终依赖 ok 判断：
import (
"os"
"golang.org/x/sys/unix"
)
func getUIDGID(fi os.FileInfo) (uid, gid uint32, ok bool) {
sys := fi.Sys()
if sys == nil {
return 0, 0, false
}
if st, ok := sys.(*unix.Stat_t); ok {
return st.Uid, st.Gid, true
}
return 0, 0, false
}
- 必须先 import
golang.org/x/sys/unix，不能用旧的syscall -
fi.Sys()返回值类型取决于 OS 和 Go 版本，永远用类型断言 +ok，不强转 - 函数返回
ok == false时，不代表出错，而是“该平台不支持”或“数据不可用”，调用方需按此分支处理
os.Stat 与 os.Lstat 在符号链接场景下的关键区别
这不是“跟不跟链接”的简单问题，而是“读谁的元数据”：前者读目标文件，后者读链接文件自身。这个差异直接影响 uid/gid、size、mtime 等字段是否可信。
立即学习“go语言免费学习笔记（深入）”；
- 用
os.Stat读一个已损坏的软链（目标被删）→ 返回no such file or directory - 用
os.Lstat读同一软链 → 成功返回链接自身的FileInfo，fi.Mode() & os.ModeSymlink != 0为 true - 想获取链接指向的目标的 uid/gid？先
os.Lstat确认是 link，再os.Stat获取目标 —— 但两次调用间目标可能被删/改，有竞态 - 判断路径是否为符号链接，必须基于
os.Lstat结果，os.Stat会穿透
os.ReadDir 比 filepath.Walk 快，但别误用它的 FileInfo
os.ReadDir 返回的 fs.DirEntry 轻量，只含名字、是否为目录、是否为符号链接等基础信息；调用 .Info() 才触发 stat 系统调用。很多人直接对每个 DirEntry 调 .Info()，性能反而不如 filepath.Walk。
- 如果只要文件名和 isDir/isSymlink → 直接用
DirEntry.Name()和DirEntry.IsDir()，零系统调用开销 - 如果还要 size/modtime/uid/gid → 按需对特定项调
DirEntry.Info()，避免批量 stat -
os.FileInfo.Size()对目录返回 0（POSIX 行为），不能用来判断目录是否为空；要用os.ReadDir看子项数量 - 某些特殊文件（如
/proc/kcore）报告极大Size()却无法全读，流式读取时务必加长度限制，否则 OOM
真正难的不是写对某一行类型断言，而是记住：每次调 fi.Sys() 都是一次平台契约的试探，它可能返回 nil、可能类型不一致、可能字段语义完全不同。跨平台不是写一次跑三处，是每处都得有 fallback 和明确的“不支持”路径。
