std::variant多层嵌套必须手动逐层visit或压平建模，否则编译失败或运行时抛std::bad_variant_access；编译器仅检查最外层类型列表，内层variant被视为普通类型，不会自动递归visit。
std::variant 多层嵌套消息不能靠一次 std::visit 自动穿透分发，必须手动逐层展开或压平建模；否则轻则编译失败，重则运行时抛 std::bad_variant_access，且调试极难定位。
std::visit 不会递归进入内层 std::variant
编译器只检查最外层 std::variant 的类型列表，遇到内层 std::variant（比如 std::variant<int std::variant char>></int>）就当作一个普通类型，不会自动再调一次 std::visit。
- 错误写法：
std::visit([](auto&& x) { /* x 可能是 int 或 std::variant<bool char>，但不会自动再 visit 内层 */ }, outer)</bool>—— 编译报no matching function for call to 'visit'（漏了内层类型分支） - 写了内层分支但没二次
std::visit：比如[](const std::variant<bool char>& inner) { std::cout —— 运行时访问 <code>std::get<bool>(inner)</bool>会直接崩 - 泛型 lambda 在嵌套中失效：它把整个内层
std::variant当作一个参数绑定，无法继续分发，失去类型安全
双层嵌套必须显式套两层 std::visit + std::overload
用 std::overload 组合外层分支，并在内层类型分支中再次调用 std::visit，才能安全覆盖所有路径。
- 外层 visitor 必须显式列出所有可能类型，包括内层
std::variant类型本身 - 对内层类型分支，用
[&](const InnerVariant& inner) { std::visit([](auto&& x) { /* 处理 bool / char */ }, inner); }—— 捕获[&]是为了透传上下文（如session_id），且auto&&适配右值构造的内层 variant - 别用
std::get_if手动提取再调std::visit：若std::get_if返回nullptr，后续调用未定义 - 每个 lambda 参数 cv 限定必须匹配：外层
std::variant是const？那对应 lambda 就得写const InnerVariant&
三层及以上嵌套别硬写全量分支
三层各含 3 种类型 → 27 条路径，手写极易遗漏、维护成本陡增，且编译时间飙升。
- 放弃“全展开”，改用
v.index()拼元组查表：std::make_tuple(a.index(), b.index(), c.index()) - 预定义静态 dispatch 表：
static constexpr auto dispatch_table = std::array{&handle_a0_b1_c2, &handle_a0_b1_c3, ...}，编译期可校验覆盖 - 或压平为单层
std::variant<:tuple b c>></:tuple>，但需手动枚举所有合法组合，且 tuple 元素顺序和 cv 限定必须严格一致 - 协议建模优先扁平化：比如
struct Message { Header hdr; std::variant<textpayload binarypayload errorpayload> payload; }</textpayload>，先按hdr.type分流，再单独std::visitpayload
valueless_by_exception 状态必须每层检查
std::variant 在异常中途构造失败时会进入 valueless_by_exception 状态，该状态存在于任意一层；std::visit 遇到它会直接抛 std::bad_variant_access，无法靠外层 try/catch 一劳永逸。
- 每层
std::visit前都得加if (!v.valueless_by_exception())检查 - 别假设“只要外层有值，内层就一定有值”——内层 variant 可能因移动构造异常而 valueless
- 网络解析场景尤其危险：buffer 解析失败后强行
v.emplace<t>(...)</t>，若T构造抛异常，v就进 valueless 状态 - 推荐做法：先完成完整解析（深拷贝或
std::span绑定），再构造std::variant，避免中间态污染
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
