std::counting_semaphore构造时括号内传初始许可数（如3表示最多3线程并发），模板参数为无符号整型类型（如uint16_t）；acquire()阻塞获取，try_acquire()非阻塞探测；必须RAII确保release()配对调用；Windows下MinGW可能需换libc++或降级实现。
std::counting_semaphore 构造时传多少值才对
初始化值直接决定最多几个线程能同时通过 acquire()，它不是“上限阈值”，而是初始可用的许可数。比如想限制最多 3 个线程并发访问某资源，就得构造 std::counting_semaphore(3) —— 注意模板参数是整型大小（通常用 1 或 2），括号里才是初始计数值。
常见错误是写成 std::counting_semaphore(3)，这会编译失败：模板参数必须是能表示最大许可数的无符号整型类型（如 std::size_t），不是你想支持的并发数。
- 想控 100 个并发？用
std::counting_semaphore(100)（uint16_t足够） - 超过 65535？得用
std::counting_semaphore(n)（对应uint32_t） - 别用
std::counting_semaphore—— 大多数标准库实现不支持 64 位底层原子操作，会静态断言失败
acquire() 和 try_acquire() 别混用场景
acquire() 是阻塞式，线程会挂起直到拿到许可；try_acquire() 立即返回 bool，成功才继续。二者语义完全不同，不能靠“加个 if 就等价”来切换。
典型误用：在循环里反复调 try_acquire() + std::this_thread::yield() 模拟阻塞 —— 这会空转 CPU，且无法响应中断或超时。
立即学习“C++免费学习笔记（深入）”；
- 需要等待资源？只用
acquire()（或带超时的try_acquire_for()/try_acquire_until()） - 做非阻塞探测（比如快速判断当前能否进临界区）？才用
try_acquire() -
try_acquire()成功后必须配对release()，否则许可永久泄漏
release() 调用时机不对会导致资源竞争或死锁
release() 的作用是归还一个许可，但它本身不保证线程安全 —— 你得确保它只在持有许可后、且不再访问受保护资源之后调用。最常踩的坑是异常绕过 release()。
比如手动管理：
sem.acquire(); // ... 可能抛异常的操作 resource.use(); sem.release(); // ← 异常发生时这行根本不会执行
正确做法是 RAII 封装：
struct semaphore_guard {
std::counting_semaphore<1>& sem;
semaphore_guard(std::counting_semaphore<1>& s) : sem(s) { sem.acquire(); }
~semaphore_guard() { sem.release(); }
};
// 使用：
{
semaphore_guard g(sem);
resource.use(); // 异常也自动 release
}
- 别在析构函数里再调
acquire()—— 那不是“重入”，是逻辑错乱 -
release()可以在任意线程调用，不限于acquire()所在线程（这点和 mutex 不同） - 释放数量超过当前已获取数？未定义行为 —— 标准没规定，实际可能触发 assert 或静默溢出
Windows 上链接失败或运行时报错 “undefined reference to `CreateSemaphoreExA`”
这是 libstdc++（GCC）在 Windows 下的已知问题：C++20 的 std::counting_semaphore 依赖系统信号量 API，但 MinGW-w64 的旧版 libstdc++ 没完全实现，或者链接时没加 -latomic。
验证方式：编译时加 -D_GLIBCXX_CONCEPTS 并检查是否启用 C++20 模式；运行时报错则大概率是 ABI 不匹配。
- MSVC 用户基本没问题（VS 2019 16.11+ 原生支持）
- MinGW-w64 用户优先换用 libc++（Clang +
-stdlib=libc++），或升级到最新版工具链 - 实在不行，退回到
std::mutex+std::condition_variable手写计数信号量 —— 但要注意 spurious wakeup 和 wait-loop 条件检查
跨平台项目里，别假设 std::counting_semaphore 在所有环境都开箱即用；CI 里至少要覆盖 Windows MSVC 和 Linux GCC 两种配置。
