登录
首页 >  Golang >  Go教程

Go语言获取系统信息全攻略

时间:2026-02-28 11:54:51 424浏览 收藏

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

如何在 Go 中获取系统信息(CPU、内存、磁盘、主机等)

本文介绍使用 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学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>