std::counting_semaphore 不支持超时，得换方案
标准 C++20 的 std::counting_semaphore 没有 try_acquire_for 或 try_acquire_until 这类带超时的成员函数——它只有阻塞式的 acquire() 和非阻塞的 try_acquire()。如果你需要「等 5 秒拿不到就放弃」，直接用它不行，得自己封装或换底层机制。
常见错误是强行用 try_acquire() 配合循环 + std::this_thread::sleep_for 模拟超时，但这会浪费 CPU、不精确、且无法响应中断（比如线程被 std::jthread 请求停止）。
- 真正可靠的超时等待必须基于系统级可中断等待，比如 Linux 的
sem_timedwait或 Windows 的WaitForSingleObjectEx - C++ 标准库不暴露这些能力，所以得绕过
std::counting_semaphore，用 POSIX 或 Win32 原生信号量封装 - 别试图给
std::counting_semaphore加锁+条件变量模拟超时——竞态多、逻辑重、性能差
Linux 下用 sem_timedwait 实现可超时信号量
POSIX 信号量（sem_t）原生支持超时：sem_timedwait 接收绝对时间点（struct timespec），超时立即返回 -1 并设 errno = ETIMEDOUT。这是最轻量、最符合语义的做法。
注意：POSIX 信号量分命名（sem_open）和未命名（sem_init）两种，线程内同步必须用未命名版，且需在堆或静态存储上分配（栈上 sem_t 可能因线程栈销毁导致 UB）。
立即学习“C++免费学习笔记（深入）”；
- 初始化必须调用
sem_init(&sem, 0, initial_value)，第二个参数为0表示线程间共享（非进程间） -
sem_timedwait的超时时间是绝对时间，不是相对时长，需用clock_gettime(CLOCK_REALTIME, &ts)+ 手动加偏移计算 - 务必检查返回值：成功返回
0；超时返回-1且errno == ETIMEDOUT；其他负值可能是EINTR（被信号打断），需重试
// 示例：等待最多 100ms
struct timespec ts;
clock_gettime(CLOCK_REALTIME, &ts);
ts.tv_nsec += 100 * 1000000;
if (ts.tv_nsec >= 1000000000) {
ts.tv_sec++;
ts.tv_nsec -= 1000000000;
}
int r = sem_timedwait(&sem, &ts);
if (r == 0) {
// 成功获取
} else if (errno == ETIMEDOUT) {
// 超时，继续干别的
} else if (errno == EINTR) {
// 被信号打断，可选择重试或退出
}Windows 下 WaitForSingleObjectEx 是唯一靠谱选择
Windows 没有 POSIX 信号量对应物，但 WaitForSingleObjectEx 支持超时 + 可中断（通过 bAlertable = TRUE 响应 APC）。配合 CreateSemaphoreEx 创建的内核信号量，就能实现等效行为。
别用 std::condition_variable + std::mutex 模拟——它只能等相对时间（wait_for），且无法在等待中被外部取消；而 WaitForSingleObjectEx 在线程收到 APC 时会提前返回 WAIT_IO_COMPLETION，适合与 std::jthread 的 stop_token 协作。
-
CreateSemaphoreEx的dwMaximumCount必须大于lInitialCount，否则创建失败 - 超时单位是毫秒，传
100就是 100ms；传0等价于try_acquire()，传INFINITE则永久阻塞 - 返回值为
WAIT_OBJECT_0表示拿到信号量；WAIT_TIMEOUT表示超时；WAIT_IO_COMPLETION表示被 APC 中断（比如线程 stop_requested）
跨平台封装要注意的三个硬伤
想写一次代码跑两边？小心这三点：一是 POSIX 信号量和 Windows 信号量资源释放方式不同（sem_destroy vs CloseHandle），忘记清理会导致句柄泄漏；二是超时精度差异大（Linux sem_timedwait 精度依赖系统 timer，Windows 在低负载下可到 1–15ms）；三是错误码体系完全不兼容（ETIMEDOUT vs WAIT_TIMEOUT），抽象层必须做映射。
最容易被忽略的是：POSIX 未命名信号量不能跨进程复用，但 Windows CreateSemaphoreEx 默认就是跨进程的——如果误把 Windows 版信号量用于纯线程场景，会引入不必要的内核对象开销和权限检查。
- 不要在析构函数里直接调用
CloseHandle或sem_destroy：Windows 句柄可能已被其他线程关闭；POSIXsem_destroy要求信号量无人等待，否则 UB - 避免在信号量等待路径里做耗时操作（比如日志、内存分配），否则超时逻辑会被拖慢甚至失效
- 如果项目已重度依赖
std::counting_semaphore，与其强行改造，不如在业务层用std::jthread+stop_token主动取消等待任务——有时候换思路比换原语更稳
