syscall.Statfs 是获取原始磁盘空间数据最底层可靠的方式，Linux/macOS 上用 Blocks×Frsize 和 Bavail×Frsize 计算总容量与可用空间，注意 Frsize 是基本块大小、Bavail 是非特权用户可用块数。
用 syscall.Statfs 获取原始磁盘空间数据
Go 标准库没有直接暴露磁盘容量的跨平台接口，syscall.Statfs 是最底层、最可靠的方式，尤其在 Linux/macOS 上能拿到精确的块数和 inode 信息。Windows 需走 syscall.GetDiskFreeSpaceEx，但多数服务端场景跑在类 Unix 系统上，优先掌握这个。
常见错误是传入路径后没检查返回值，或忽略 statfs.Bsize 和 statfs.Frsize 的区别——前者是 I/O 块大小，后者才是文件系统基本块大小，计算容量必须用 Frsize。
- 务必对
syscall.Statfs的返回错误做判断，比如路径不存在、权限不足会直接 panic 或返回 0 值 - 总容量 =
statfs.Blocks * statfs.Frsize，可用空间 =statfs.Bavail * statfs.Frsize（注意是Bavail，不是Bfree） -
Bavail是非特权用户可用块数，Bfree是所有用户可用块数，监控场景必须用Bavail
var s syscall.Statfs_t
if err := syscall.Statfs("/tmp", &s); err != nil {
log.Fatal(err)
}
total := uint64(s.Blocks) * uint64(s.Frsize)
available := uint64(s.Bavail) * uint64(s.Frsize)用 golang.org/x/sys/unix 替代裸 syscall
原生 syscall 包已弃用，且跨平台行为不一致；golang.org/x/sys/unix 是官方维护的替代品，API 更稳定，Linux/macOS 支持完整，Windows 则需另寻方案。
容易踩的坑是 import 错误路径（比如写成 golang.org/x/sys/unix/syscall），或者没加构建约束导致 Windows 编译失败。
立即学习“go语言免费学习笔记（深入）”；
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 导入必须是
import "golang.org/x/sys/unix"，不是syscall - 函数名变为
unix.Statfs，参数类型和返回值与旧版一致，但更安全 - 如果项目需支持 Windows，得用构建标签 + 条件编译，例如
//go:build !windows
为什么不用 os.Stat 或 filepath.WalkDir
os.Stat 只能查单个文件/目录元信息，完全不提供挂载点级别的容量数据；filepath.WalkDir 是遍历文件用的，性能差、不准、还可能因权限被中断——它根本不是为查磁盘设计的。
有人试过用 du -sh 调外部命令，问题更严重：依赖 shell、不可靠、无超时控制、输出格式易变，线上服务应杜绝这种做法。
- 查磁盘 ≠ 查目录大小，这是两个不同层级的概念
- 任何基于遍历或外部命令的方案，在容器、chroot、overlayfs 等环境下大概率失效
- 即使只读取
/proc/mounts或/proc/self/mountinfo，也比调du强，但依然不如Statfs直接
注意挂载点与路径的绑定关系
磁盘空间是按挂载点（mount point）统计的，不是按路径字面意思。比如 /data 是一个独立挂载的 ext4 分区，而 /data/logs 只是其子目录——查 /data/logs 和查 /data 得到的结果完全一样。
常见错误是拿任意路径去调 Statfs，却没确认该路径是否落在目标挂载点上。比如容器内查 /app/config.yaml，实际返回的是根文件系统的空间，而非 config 所在卷的容量。
- 必要时先用
unix.Statfs查路径所在挂载点，再用unix.Readlink("/proc/self/mountinfo")解析，但通常只需确保传入的是挂载点根路径 - Docker/K8s 场景下，宿主机挂载进来的 volume 路径，必须在容器内对应位置执行
Statfs - 不要假设
/总是主磁盘——有些系统把/home或/var单独挂载，得按需指定
事情说清了就结束。真正难的不是调哪个函数，而是搞懂你要查的“那个磁盘”，到底对应哪个挂载点、有没有被 overlay 或 bind mount 隐藏了真实设备。
