先说几个核心判断。跨平台获取CPU总负载率这件事，代码量不大，但坑不少。不同操作系统对“CPU利用率”的定义和采集路径完全不同，直接上同一套逻辑写死，多半要出事。下面逐平台拆清楚。
Linux下用/proc/stat计算CPU总负载率
Linux这边最标准的做法，其实藏在 /proc/stat 这个文件里。内核把CPU时间统计全摊开在这儿了，轻量而且可靠。怎么算呢？关键不是读一次就能拿到“实时百分比”，而是采样两个时间点的 cpu 行数据，做差值后算出占用比例。
需要注意一个细节：/proc/stat 中第一行以 cpu 开头的记录是所有CPU核心的累加值（注意是 cpu，不是 cpu0），字段顺序为 user、nice、system、idle、iowait、irq、softirq、steal、guest、guest_nice。其中 user + nice 是用户态时间，system + irq + softirq 是内核态时间，idle 是空闲时间。
- 必须两次读取，间隔建议至少 100ms，否则差值为0或失真
- 不能直接用单次读取除以固定周期——内核只提供单调递增的计数器，不提供“当前秒级负载”
iowait不属于“忙”状态，但常被误计入负载；严格意义的“CPU忙时占比”应为(total - idle) / total- 示例逻辑（伪代码）：
auto [u1,n1,s1,i1,...] = parse_stat_line("/proc/stat", "cpu");std::this_thread::sleep_for(200ms);auto [u2,n2,s2,i2,...] = parse_stat_line("/proc/stat", "cpu");auto busy = (u2-u1)+(n2-n1)+(s2-s1)+(i2-i1)+(...); // 所有非idle项之和auto total = busy + (i2-i1);double load_pct = static_cast(busy) / total * 100.0;
Windows下用PDH API获取Processor(_Total)% Processor Time
Windows这边就没那么直接了，没有类似 /proc 的文本接口，得靠性能数据助手（PDH）API。目标计数器是 Processor(_Total)% Processor Time，它等价于 Linux 的 (total - idle)/total，已经自动把所有逻辑处理器聚合起来，归一化到 0–100% 范围。
这个值本质上也是采样差值计算的结果，只不过 PDH 把底层细节都封装好了。需要留意的是，它默认不直接暴露用户态/内核态的拆分——如果需要明细，得额外采集 Process(_Total)% User Time 和 Process(_Total)% Privileged Time，二者之和才接近总负载（但存在微小偏差，特权时间含中断等不可归因部分）。
- 必须调用
PdhOpenQuery→PdhAddCounter→PdhCollectQueryData至少两次，间隔建议 ≥1s 才有意义 - 首次
PdhCollectQueryData返回PDH_INVALID_DATA是正常现象，忽略它，等第二次调用 - 不要用
GetSystemTimes：它返回的是自系统启动以来的 FILETIME，精度低且难以对齐采样窗口，误差常超过 ±5% - 务必检查
PdhGetFormattedCounterValue返回值是否为PDH_CSTATUS_SUCCESS，否则拿到的double值不可信
跨平台封装时别碰macOS的host_processor_info
macOS 的情况有点特殊。 host_processor_info 这个API看上去挺直观，能拿到各状态时间，但问题在于它返回的是“自上次调用以来的增量”，而且文档里明确警告过：这个API已经废弃了，行为不稳定，不同系统版本返回的结构可能都不一样。更麻烦的是，它不区分用户/内核态，只返回 user_time、system_time、idle_time 三类，而 system_time 包含了中断、软中断、上下文切换等开销，根本无法与Linux的 system+irq+softirq 对齐。
- 官方推荐方案是走
libtop（私有API）或解析sysctl的vm.loada vg——但那是平均队列长度，不是CPU利用率 - 真正可用的替代是
process_policy+host_statistics组合，但需要root权限，而且返回值单位是mach_timebase_info换算后的纳秒，极易溢出或精度丢失 - 绝大多数生产场景下，macOS 干脆放弃“精确总负载率”的执念，改用
sysctl -n hw.ncpu+top -l 1 -s 0 | grep 'CPU usage'这类shell命令兜底（仅作参考，不用于监控告警）
用户态/内核态拆分在不同系统上含义不一致
这里其实藏着一个很容易被忽略的坑。所谓“用户态时间”，在Linux里指的是进程在用户空间执行的时钟周期；而“内核态时间”则是指同一进程陷入内核执行系统调用、处理中断等操作的时间。但是Windows那边的定义完全不一样。% User Time 实际包含所有线程在用户模式下的时间，% Privileged Time 则涵盖内核模式下所有代码（包括驱动、DPC、ISR），并不绑定到具体进程。这就意味着：即使你把Linux的 user+nice 和 system+irq+softirq 加起来，跟Windows的 User+Privileged 对比，数值上也会出现 2–8% 的系统性偏差，在高IO或虚拟化环境下尤其明显。
- 别指望让跨平台程序输出“完全一致”的用户/内核占比——底层度量逻辑差异太大，强行对齐反而会误导人
- 如果业务确实依赖明细拆分，建议在每个平台单独实现采集逻辑，并在文档里注明“此值仅作趋势参考，不可跨平台横向比较”
- 监控告警阈值按平台分别设置会更稳妥：比如Linux设 85% 总负载触发，Windows设 92%，macOS用 75%（因为实现比较粗糙）
说到底，真正的难点不在代码怎么写，而在于理解每行数字背后的调度语义——同一串“system=123456789”在Linux和Windows里，根本就不是同一个东西。
