GetSystemPowerStatus 是 Windows 获取电池电量最轻量可靠的方式，返回 SYSPOWERSTATUS 结构体，BatteryLifePercent 为 0–100 或 255（未知），需检查返回值并初始化结构体，不依赖管理员权限且兼容 XP SP3+。
Windows平台用 GetSystemPowerStatus 获取电池状态
Windows 提供了现成的 API，GetSystemPowerStatus 是最轻量、最可靠的方式，不需要管理员权限，也不依赖 WMI 或 PowerShell。它返回一个 SYSPOWERSTATUS 结构体，其中 BatteryLifePercent 字段就是你想要的剩余电量（0–100），ACLineStatus 可判断是否插电。
常见错误是忽略返回值检查或没初始化结构体：该函数失败时返回 0，但很多代码直接读 BatteryLifePercent，而未插电池的设备（比如台式机）或虚拟机可能返回 255 或无效值。
- 调用前必须将
dwFlags成员设为 0，否则部分 Windows 版本会读取失败 -
BatteryLifePercent为 255 表示“未知”，不是 100%；需显式判断：if (status.BatteryLifePercent != 255) - 该函数不触发 UAC，但仅适用于 Windows（XP SP3+），不跨平台
#include <windows.h>
#include <iostream>
int main() {
SYSTEM_POWER_STATUS status = {};
if (GetSystemPowerStatus(&status)) {
if (status.BatteryLifePercent != 255) {
std::cout <h3>Linux 下读取 <code>/sys/class/power_supply/</code> 文件系统</h3>
<p>Linux 没有统一 API，但几乎所有现代发行版都通过 sysfs 暴露电池信息，路径通常是 <code>/sys/class/power_supply/BAT0/</code>（也可能叫 <code>BAT1</code>、<code>axp288_fuel_gauge</code> 等）。关键文件是 <code>capacity</code>（当前电量百分比）和 <code>status</code>（<code>Charging</code>/<code>Discharging</code>/<code>Full</code>）。</p>
<p>容易踩的坑是硬编码路径或忽略权限问题：普通用户默认可读这些文件，但某些 OEM 设备（如部分 ThinkPad 或 Chromebook）可能把电池放在非标准路径，或需要 udev 规则支持。</p>
<ul>
<li>先遍历 <code>/sys/class/power_supply/</code> 下所有子目录，检查是否存在 <code>capacity</code> 文件</li>
<li>
<code>capacity</code> 内容是纯数字字符串（如 <code>"73\n"</code>），需 <code>std::stoi</code> 转换，注意捕获 <code>std::invalid_argument</code>
</li>
<li>若读到 <code>energy_now</code> 和 <code>energy_full</code>，可用它们算出更精确百分比（尤其对老电池），但多数设备只提供 <code>capacity</code>
</li>
</ul>
<h3>macOS 上用 IOKit 获取 <code>AppleSmartBattery</code> 数据</h3>
<p>macOS 没有 sysfs，必须用 IOKit 框架。核心是获取 <code>IOServiceMatching("AppleSmartBattery")</code> 对应的服务，再用 <code>IORegistryEntryCreateCFProperties</code> 读取属性字典。关键键是 <code>CurrentCapacity</code> 和 <code>MaxCapacity</code>，两者相除即为剩余电量。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<p>新手常卡在链接阶段：必须显式链接 <code>-framework IOKit -framework CoreFoundation</code>，且 Xcode 默认不启用 C++17 的 <code><filesystem></filesystem></code>，别试图用它找设备路径——IOKit 不走文件系统。</p>
<ul>
<li>IORegistry 查询可能返回多个匹配项（如带触控板电池），需过滤 <code>DesignCapacity</code> 或 <code>LegacyBatteryInfo</code> 存在的条目</li>
<li>
<code>CurrentCapacity</code> 和 <code>MaxCapacity</code> 是 CFNumberRef，要用 <code>CFNumberGetValue</code> 转成 int64_t，不能直接强转</li>
<li>沙盒应用（如 App Store 分发）默认无权访问 IOKit，需在 entitlements 中添加 <code>com.apple.developer.kernel.extended-system-info</code>
</li>
</ul>
<h3>跨平台封装要注意的三个实际限制</h3>
<p>没有“一次编写，到处获取电量”的标准方案。即使封装成统一接口，底层行为差异仍会导致逻辑分歧：</p>
<ul>
<li>Windows 的 <code>BatteryLifePercent</code> 是整数，Linux <code>capacity</code> 也是整数，但 macOS 返回的是浮点精度的原始容量值，四舍五入策略要自己定</li>
<li>Linux 和 macOS 都可能有多个电池（双电池笔记本、TSMC 电池模组），而 Windows API 只返回主电池汇总值</li>
<li>休眠唤醒后，Linux 的 sysfs 值可能延迟更新几秒，macOS 的 IOKit 属性偶尔缓存旧值，建议加 1–2 秒重试逻辑而非单次读取</li>
</ul>
<p>真正麻烦的不是读取本身，而是处理“无电池”“电量突变”“驱动未加载”这三类边界态——它们不会报错，只会静默返回无效数据。</p></iostream></windows.h>
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
