setthreadexecutionstate通过周期性调用“续命信号”阻止windows休眠，需组合es_continuous | es_system_required | es_awaymode_required标志，并每30–50秒刷新一次，退出时须调用es_continuous归还控制权。
Windows平台下用SetThreadExecutionState阻止休眠
在Windows上，C++程序无法“永久禁用”系统休眠（那需要管理员权限修改电源策略），但可以动态阻止系统进入休眠或待机状态——只要你的线程持续调用SetThreadExecutionState并保持活跃即可。这是最常用、最轻量、无需UAC弹窗的方案。
关键点在于：这个API不是开关式设置，而是“续命信号”。每次调用只延长一段有效期（默认约1分钟），必须周期性刷新，否则系统照常休眠。
- 必须传入
ES_CONTINUOUS | ES_SYSTEM_REQUIRED | ES_AWAYMODE_REQUIRED组合：其中ES_SYSTEM_REQUIRED防止系统休眠，ES_AWAYMODE_REQUIRED还能阻止“离开模式”（如媒体播放场景） - 不能只在程序启动时调用一次——必须在后台线程中每30–50秒调用一次，避免因线程阻塞或调度延迟导致失效
- 退出前务必调用
SetThreadExecutionState(ES_CONTINUOUS)归还控制权，否则系统可能持续不休眠，影响用户其他任务
// 示例：简单轮询（实际建议用std::thread + std::this_thread::sleep_for）
while (keep_awake) {
SetThreadExecutionState(ES_CONTINUOUS | ES_SYSTEM_REQUIRED | ES_AWAYMODE_REQUIRED);
std::this_thread::sleep_for(std::chrono::seconds(45));
}
Linux下通过org.freedesktop.login1 D-Bus接口抑制休眠
Linux没有全局API，主流桌面环境（GNOME、KDE、systemd-based发行版）依赖logind服务管理电源状态。C++需通过D-Bus调用org.freedesktop.login1的Inhibit方法申请抑制锁。
这本质是资源租约：你拿到一个文件描述符，只要它没被关闭，logind就不会触发挂起。一旦进程退出或fd关闭，抑制自动解除——比Windows方案更可靠，但也更依赖DBus可用性。
- 必须链接
libdbus-1，并确保用户会话总线（$DBUS_SESSION_BUS_ADDRESS）可访问；无桌面环境（如纯tty或server）时可能失败 -
what参数要设为"handle-lid-switch:suspend handle-power-key:suspend handle-suspend-key:suspend"才覆盖常见休眠触发源 - 调用
Inhibit返回的是一个unix:fd，必须保持该fd打开；不要用fclose或close()提前释放，否则抑制立即失效
macOS需用IOPMAssertionCreateWithName创建断言
macOS要求显式声明“为什么不能休眠”，通过I/O Kit的电源管理断言（assertion）机制实现。最常用的是kIOPMAssertionTypePreventUserIdleSystemSleep，它阻止因用户无操作导致的系统级休眠（但不影响屏幕关闭）。
注意：macOS 12+对断言有严格审计，长时间持有且无合理理由（如视频播放、下载）可能被系统强制降级或拒绝。
- 必须配对调用
IOPMAssertionRelease，否则断言泄漏，系统日志会出现Assertion failed警告，且后续申请可能被限频 - 断言名称（
name参数）应具业务含义，例如"com.myapp.download"，避免用泛用名如"keepalive"，否则审核或诊断时难以追溯 - 若还需阻止屏幕变暗，得额外申请
kIOPMAssertionTypePreventUserIdleDisplaySleep，两个断言独立管理
跨平台方案为何难做？关键差异在哪
三个平台的底层逻辑完全不同：Windows靠心跳续期，Linux靠D-Bus租约，macOS靠内核断言。强行封装成统一接口容易掩盖失效风险。
最容易被忽略的点是生命周期管理——90%的问题出在“忘记释放”或“释放太早”。比如Windows下主线程退出但后台唤醒线程还在跑，会导致SetThreadExecutionState调用失败却无提示；Linux下DBus连接意外断开，Inhibit返回的fd失效，程序却继续以为抑制有效。
真正稳定的方案，是把“抑制休眠”当作一个带健康检查的短期资源来用：启动时申请，运行中定期验证（如Windows查GetLastInputInfo是否仍被信任，Linux查org.freedesktop.login1.Manager.GetSession是否存活），异常时主动降级或告警。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
