Go语言获取系统信息全攻略
时间:2026-02-28 11:54:51 424浏览 收藏
本文深入讲解了如何使用 Go 语言最主流的系统信息采集库 gopsutil/v3 跨平台(Windows、Linux、macOS)高效获取主机名、操作系统版本、CPU 型号、物理内存总量和磁盘容量等核心硬件与系统指标,不仅提供开箱即用的完整可运行示例代码,还细致梳理了安装要点(如必须使用 v3 版本、Windows 下需额外安装 WMI 支持包)、环境配置(CGO_ENABLED=1)、路径适配、权限要求及性能优化建议,是 Go 开发者快速上手系统监控、资源感知服务和部署校验脚本的实用指南。

本文介绍使用 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:\n%+v\n", 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 等),后续如需获取进程列表、网络接口统计或电池状态,只需按需导入对应子包即可。
本篇关于《Go语言获取系统信息全攻略》的介绍就到此结束啦,但是学无止境,想要了解学习更多关于Golang的相关知识,请关注golang学习网公众号!
-
505 收藏
-
503 收藏
-
502 收藏
-
502 收藏
-
502 收藏
-
108 收藏
-
319 收藏
-
489 收藏
-
330 收藏
-
127 收藏
-
143 收藏
-
313 收藏
-
371 收藏
-
111 收藏
-
257 收藏
-
500 收藏
-
220 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习