co_await 是语法糖，需 awaitable 类型支撑；标准库无内置支持，须用第三方库或自定义 awaiter；裸指针/临时对象易致野指针；编译器支持需显式启用协程标志并链接对应运行时。
co_await 在 C++20 里不是“开箱即用”的异步工具
它只是语言层面的挂起/恢复语法糖，背后必须有你自己或第三方提供的 awaiter 类型支撑。没有 awaitable 对象，co_await 直接报错：error: use of undeclared identifier 'operator co_await'。
常见错误是以为写了 co_await some_task() 就能自动调度——其实编译器只检查 some_task() 返回值是否满足 awaitable 概念（即有没有 await_ready、await_suspend、await_resume 成员），不关心它内部干了啥。
- 标准库目前（C++20/C++23）**没提供任何可直接
co_await的异步类型**，std::future不支持，std::thread更不行 - 想用
co_await真正做 I/O 或延时，得靠libunifex、cppcoro、Boost.ASIO（1.79+）这类库封装的task、async_operation或awaitable类型 - 自己手写
awaiter要小心await_suspend返回bool（决定是否真挂起）还是std::coroutine_handle（移交控制权），返回void是非法的
为什么 std::this_thread::sleep_for 不能直接 co_await
因为它是同步阻塞调用，不是 awaitable；强行 co_await std::this_thread::sleep_for(1s) 会编译失败：error: no member named 'await_ready' in 'std::chrono::duration<...>'</...>。
真正可行的是用封装好的异步延时，比如 cppcoro::sleep_after 或 asio::steady_timer::async_wait，它们返回的对象实现了完整 awaiter 接口。
立即学习“C++免费学习笔记（深入）”；
-
cppcoro::sleep_after(500ms)返回cppcoro::task<void></void>，可co_await，底层用定时器 + 调度器唤醒协程 - Boost.ASIO 中要先有
io_context实例，再构造steady_timer，调用async_wait才返回可等待对象 - 别试图把
std::this_thread::sleep_for包进std::jthread再 await——那只是开了个线程阻塞，协程本体仍卡在当前线程，没解决并发等待问题
co_await 表达式里传裸指针或临时对象的风险
协程挂起时，局部变量可能已析构，但 await_suspend 里若还存着指向它的指针（比如 std::coroutine_handle 存在 lambda 捕获中），恢复时就是野指针访问。
典型场景：自己写的 awaiter 在 await_suspend 里把 handle 交给某个队列或 timer，但没确保该 awaiter 对象生命周期覆盖整个等待过程。
- 避免在
await_suspend中捕获局部awaiter的引用或指针；要么把它移到堆上（new awaiter{...}），要么用std::shared_ptr管理 - 如果
await_ready返回true，协程不会挂起，await_suspend根本不执行——所以不要在await_suspend里做必须发生的初始化 - 调试时注意：GDB/Lldb 对协程栈帧支持有限，
await_resume返回点可能跳得“不直观”，建议加日志或断点在await_suspend和await_resume入口
MSVC / Clang / GCC 对 co_await 的实现差异在哪
三者都支持 C++20 协程语法，但默认不开启，且运行时依赖不同。没配对启用协程支持和链接对应运行时，会链接失败或行为异常。
- MSVC：需加
/std:c++20 /await，并链接libcmt.lib（静态）或msvcp140.dll（动态），否则co_await编译通过但运行时报__builtin_coro_*符号未定义 - Clang：用
-std=c++20 -fcoroutines-ts（旧）或-std=c++20 -fcoroutines（新），还需指定-stdlib=libc++并链接libc++.a或libc++.so - GCC：10+ 支持，但协程运行时（
libcoro）未进标准库，得自己编译或用libunifex自带的轻量实现；-fcoroutines必须配合-lstdc++，否则co_yield相关符号找不到
跨平台项目最容易漏的是构建系统没统一开启协程标志，或者 CI 环境里某台机器忘了装 libc++-dev / libcoro-dev。
