本文介绍使用 gopsutil 库在 Go 中跨平台获取系统信息的方法，涵盖主机名、操作系统平台、CPU 型号、总内存与磁盘容量，并提供完整可运行示例及常见安装注意事项。
本文介绍使用 `gopsutil` 库在 go 中跨平台获取系统信息的方法，涵盖主机名、操作系统平台、cpu 型号、总内存与磁盘容量，并提供完整可运行示例及常见安装注意事项。
在 Go 生态中，若需以编程方式获取底层系统信息（如主机名、CPU 架构、内存总量、磁盘使用情况等），最成熟、广泛采用的第三方库是 github.com/shirou/gopsutil —— 它常被称作 Go 版的 psutil，支持 Windows、Linux、macOS 等主流平台，API 设计清晰，模块化程度高。
安装依赖
执行以下命令安装核心库：
go get github.com/shirou/gopsutil/v3
✅ 注意：推荐使用 v3 版本（当前最新稳定版），其模块路径为 github.com/shirou/gopsutil/v3，而非旧版 v2 或无版本后缀的仓库。旧文档中常见的 github.com/shirou/gopsutil 默认指向 v2，已归档，不建议新项目使用。
在 Windows 平台下，部分功能（如 host.Info()、cpu.Info()）依赖 WMI（Windows Management Instrumentation），因此还需安装 WMI 支持包：
go get github.com/StackExchange/wmi
此外，请确保已启用 CGO（CGO_ENABLED=1），因为 gopsutil 在 Windows 上通过 CGO 调用系统 API，在 Linux/macOS 上亦依赖 C 标准库。你的环境配置中 CGO_ENABLED=1 已满足要求，无需额外修改。
示例：获取基础系统信息
以下是一个完整、可直接运行的 Go 程序，用于获取主机名、操作系统平台、CPU 型号、物理内存总量和系统盘总容量（Windows 默认为 C:，即 "\ "；Linux/macOS 请改为 "/"）：
package main
import (
"fmt"
"log"
"github.com/shirou/gopsutil/v3/cpu"
"github.com/shirou/gopsutil/v3/disk"
"github.com/shirou/gopsutil/v3/host"
"github.com/shirou/gopsutil/v3/mem"
)
// SysInfo 封装关键系统指标（单位统一为 MB）
type SysInfo struct {
Hostname string `json:"hostname"`
Platform string `json:"platform"`
CPU string `json:"cpu"`
RAMMB uint64 `json:"ram_mb"`
DiskMB uint64 `json:"disk_mb"`
}
func main() {
// 获取主机信息
hostStat, err := host.Info()
if err != nil {
log.Fatal("failed to get host info:", err)
}
// 获取 CPU 信息（取首个逻辑 CPU 的型号）
cpuStats, err := cpu.Info()
if err != nil {
log.Fatal("failed to get cpu info:", err)
}
cpuModel := "unknown"
if len(cpuStats) > 0 {
cpuModel = cpuStats[0].ModelName
}
// 获取内存信息
vmStat, err := mem.VirtualMemory()
if err != nil {
log.Fatal("failed to get memory info:", err)
}
// 获取系统盘（Windows: "\"，Linux/macOS: "/"）
rootPath := "\"
diskStat, err := disk.Usage(rootPath)
if err != nil {
log.Fatal("failed to get disk usage:", err)
}
info := &SysInfo{
Hostname: hostStat.Hostname,
Platform: fmt.Sprintf("%s %s", hostStat.Platform, hostStat.PlatformVersion),
CPU: cpuModel,
RAMMB: vmStat.Total / 1024 / 1024,
DiskMB: diskStat.Total / 1024 / 1024,
}
fmt.Printf("System Information:
%+v
", info)
}✅ 运行效果示例（Windows）：
System Information:
&{Hostname:"DESKTOP-ABC123" Platform:"windows 10.0.22631" CPU:"Intel(R) Core(TM) i7-10875H CPU @ 2.30GHz" RAMMB:16714752 DiskMB:255997952}注意事项与最佳实践
- 错误处理不可省略：示例中为简洁展示使用了 _ 忽略错误，但生产代码务必检查每个 gopsutil 调用的返回错误，避免 panic 或静默失败。
- 路径适配：disk.Usage(path) 的 path 参数必须是挂载点（如 Windows 的 "\ "、Linux 的 "/"）。传入无效路径将导致 ErrNotFound 或权限错误。
- 权限要求：在 Linux/macOS 上，部分信息（如某些 CPU 频率或进程级硬件指标）可能需要 root 权限；Windows 下通常无需管理员权限，但 WMI 查询受系统策略影响。
- 性能考量：cpu.Info()、host.Info() 等函数涉及系统调用，不宜高频轮询；如需监控，建议缓存结果并设定合理间隔（如 30 秒以上）。
- 跨平台兼容性：gopsutil/v3 模块自动根据 GOOS 选择对应实现，同一份代码编译后可在不同系统运行，但需注意字段可用性差异（例如 host.KernelArch 在 Windows 下为空）。
掌握 gopsutil/v3 的基础用法，即可快速构建系统监控工具、部署检查脚本或资源感知型服务。其模块划分明确（cpu、mem、disk、host、process 等），后续如需获取进程列表、网络接口统计或电池状态，只需按需导入对应子包即可。
