用 C 打造实时硬件监视器hwinfo monitoring 子库与 live_monitor 示例深度解析【免费下载链接】hwinfocross platform C library for hardware information (CPU, RAM, GPU, ...)项目地址: https://gitcode.com/gh_mirrors/hw/hwinfohwinfo是一个跨平台的C 硬件信息库用一套现代、易用的 API 即可读取 CPU、内存、GPU、磁盘、主板等硬件信息。而它的monitoring 子库更进一步内置后台定时采样引擎MonitorT与 CPU / 内存 / 磁盘三类实时指标采集函数配合官方的live_monitor 示例只需几十行代码就能打造一个每秒刷新、原地重绘的实时硬件监视器类似轻量版任务管理器。本文带你深度解析这套子库的设计思路并手把手跑通示例。本文你将学到monitoring 子库的 4 个核心头文件各自负责什么MonitorT模板如何做到后台定时采样 回调推送live_monitor 示例如何做到终端内每秒刷新而不刷屏最快构建与运行步骤、以及新手最容易踩的 3 个坑 hwinfo 与 monitoring 子库的关系hwinfo 主体如 src/cpu.cpp 所在的公共接口提供的是静态快照CPU 型号、核心数、内存总量、磁盘列表等出生时信息。而monitoring子库专门解决动态指标的读取模块头文件路径能采集什么采样引擎include/hwinfo/monitoring/monitor.h通用模板类MonitorT后台线程周期执行采集 → 回调CPU 监控include/hwinfo/monitoring/cpu.h总占用率、每线程占用率、每线程当前频率 (Hz)内存监控include/hwinfo/monitoring/ram.h空闲内存 (free)、可用内存 (available)磁盘监控include/hwinfo/monitoring/disk.h各挂载点的剩余字节数每个模块都遵循统一模式一个Data快照结构体 一个fetch()函数 一个Monitor类型别名。你既可以直接调用fetch()手动采集也可以用Monitor交给后台线程自动循环采集——这是本库设计上最优雅的地方。⚙️ 核心引擎MonitorT模板类monitor.h只有约 60 行却实现了完整的采样器hwinfo::monitoring::MonitorSnapshot monitor(fetch_all, render, 1s); monitor.start(); // 后台线程开始每 1 秒执行 fetch_all并把结果传给 render它的工作循环可以概括为 3 步采集调用你传入的FetchFn例如读取 CPU/内存/磁盘指标推送把结果作为只读引用交给你的Callback例如渲染到终端休眠用条件变量等待一个interval如 1 秒并支持随时被stop()唤醒退出。几个值得新手学习的工程细节线程安全停止_running是std::atomicboolstop()通过条件变量通知采样线程能立即醒来退出不会傻等到下一轮结束RAII 兜底析构函数自动调用stop()即使你忘了手动停止也不会泄漏后台线程禁止拷贝/移动Monitor显式删除了拷贝和移动操作语义上一个监视器绑定一个线程避免多线程竞争。 三大监控数据源的工作原理三个fetch()在不同平台有不同实现源码分别位于src/linux/monitoring/、src/windows/monitoring/、src/apple/monitoring/。以 Linux 为例理解原理后你会明白为什么 CPU 采样要等 200 毫秒1️⃣ CPU 占用率两次读表求差值Linux 的 CPU 计数器在/proc/stat里只增不减所以算法是见 src/linux/monitoring/cpu.cpp采样前读一次每个逻辑核的累计计时jiffies→睡 200 ms→采样后再读一次 → 用忙碌时间增量 ÷ 总时间增量得到该线程的占用率0~1 之间。这也解释了 API 签名里那个参数fetch(std::chrono::milliseconds sleep 200ms)会阻塞 200 ms 来测量差值。采样间隔建议 ≥ 采集耗时否则会重叠采样。每线程的实时频率则来自/sys/devices/system/cpu/cpuN/cpufreq/scaling_cur_freq。2️⃣ 内存free ≠ availableram::Data里有两个字段含义不同见include/hwinfo/monitoring/ram.hfree_bytes完全没被用过的物理内存available_bytes可分配给新进程的内存含可回收的缓存这个数值才是还能用多少的真实答案。Linux 实现直接解析/proc/meminfo的MemFree/MemAvailable两行非常轻量。3️⃣ 磁盘按挂载点统计剩余空间disk::fetch(mount_point)返回单个挂载点的剩余字节数Linux 下通过statvfs系统调用实现。想监控整块磁盘调用重载的get_free_size(const Disk)会自动把该盘所有挂载点加总。️ live_monitor 示例深度拆解官方示例 examples/live_monitorMain.cpp 是整个仓库最好的实战教材它演示了如何组装出一个原地刷新的实时硬件监视器第 1 步先打印一次静态信息启动时调用hwinfo::getAllCPUs()、hwinfo::getAllDisks()等打印 CPU 型号、内存总量、磁盘型号与挂载点——这些只印一次避免每秒重复输出。第 2 步定义一个快照结构体struct Snapshot { hwinfo::monitoring::cpu::Data cpu; hwinfo::monitoring::ram::Data ram; std::vectorhwinfo::monitoring::disk::Data disks; };把三类指标打包成一个T就能复用MonitorT模板——这正是模板引擎的威力你不需要为每种数据单独写采样线程。第 3 步采集函数 1 秒循环auto fetch_all []() - Snapshot { Snapshot s; s.cpu hwinfo::monitoring::cpu::fetch(200ms); // CPU 采集需阻塞 200ms s.ram hwinfo::monitoring::ram::fetch(); for (const auto mp : mount_points) s.disks.push_back(hwinfo::monitoring::disk::fetch(mp)); return s; }; hwinfo::monitoring::MonitorSnapshot monitor(fetch_all, render, 1s); monitor.start();第 4 步原地重绘而非刷屏这是示例最精彩的一笔渲染时先用 ANSI 转义序列\033[NA把光标上移 N 行N 上一帧行数再覆盖写入新内容从而实现终端内的逐帧刷新效果。单位换算则复用include/hwinfo/utils/unit.h里的unit_prefix_to()把字节自动转成 GiB、把 Hz 转成 MHz。运行起来的效果大致如下按 CtrlC 退出 hwinfo live monitor (CtrlC to quit) CPU : GenuineIntel Intel(R) Core(TM) i7-10700K CPU 3.80GHz (8 physical / 16 logical) RAM : 63.9 GiB total CPU avg : [##########..........] 51.3% T00 : [#####.............] 25.0% 3792 MHz T01 : [..................] 0.0% 3792 MHz RAM free: 21.37 GiB available: 42.11 GiB Disk [/] free: 478.2 GiB第 5 步优雅退出示例同时处理了 Linux 的SIGINT与 Windows 的SetConsoleCtrlHandler按下 CtrlC 时置位原子标志g_running主循环退出后调用monitor.stop()干净地回收线程。 最快上手构建并运行 live_monitor环境要求git、cmake、任意 C 编译器gcc / clang / MSVC。# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/hw/hwinfo cd hwinfo # 2. 构建同时产出静态库与动态库 cmake -B build -DCMAKE_BUILD_TYPERelease cmake --build build --config Release # 3. 运行实时监视器示例 ./build/examples/live_monitor示例由 examples/CMakeLists.txt 定义与一次性打印硬件报告system_info示例见examples/system_infoMain.cpp并列。如果你的项目只需要监控功能还可以用 CMake 选项按需裁剪例如-DHWINFO_GPUOFF关闭 GPU 模块各模块默认开启显著减小链接体积。 实用技巧与新手避坑指南⏱️采样间隔别小于采集耗时cpu::fetch()会阻塞 200 ms所以监视间隔至少设为 300 ms~1 slive_monitor 选择 1 s 正是这个原因。展示内存时用 available 而不是 free只报 free 会误导用户内存快满了available 才反映真实可用容量。Monitor不可拷贝想在多个界面共享一份数据在回调里把const T拷贝给需要的地方或加锁共享而不是复制监视器本身。️Windows 上的 ANSI 颜色/转义live_monitor 专门调用了SetConsoleMode启用虚拟终端处理否则转义序列会原样显示。组合自定义指标MonitorT对T没有任何要求你可以fetch()自己构造的任意结构体——比如把温度、网络吞吐配合include/hwinfo/network.h一起打包监控。 小结hwinfo 的 monitoring 子库用极小的代码量展示了现代 C 硬件监控的完整范式模板引擎解耦定时与数据、fetch()抽象屏蔽平台差异Linux 的/proc、Windows 的 WMI/powrprof、macOS 的 IOKit 各有一套实现接口却完全一致。配合 live_monitor 示例你现在已经掌握了✅ 如何用MonitorT搭建后台定时采样循环✅ 如何读取 CPU 占用率、内存、磁盘三大实时指标✅ 如何用 ANSI 转义实现终端原地刷新动手把示例编译跑起来再试着往Snapshot里加一个指标你会立刻体会到这套 API 的可扩展性。祝编码愉快【免费下载链接】hwinfocross platform C library for hardware information (CPU, RAM, GPU, ...)项目地址: https://gitcode.com/gh_mirrors/hw/hwinfo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
