在C++17引入的众多特性中,std::variant绝对算得上是最实用的“类型安全”利器之一。它本质上是一个带标签的联合体(tagged union),专门用来解决传统 union 的两大顽疾:一是完全没有类型记录,访问错了就是未定义行为;二是无法容纳那些有复杂构造/析构逻辑的类型,比如 std::string。而 std::variant 在编译期就锁定了一个类型列表,运行时则自动记录当前“活跃”的是哪一个,并替你管理好构造和析构。配合 std::get、std::holds_alternative 和 std::visit 这套安全访问机制,它让“一个变量,多种类型”这件事变得优雅且可靠。

std::variant 是什么,它解决什么问题
简单来说,当你需要一个变量能存几种不同类型的东西(比如 int、std::string、double),但又不想回到 void* 或裸 union 那种手动管理类型和生命周期的原始时代,std::variant 就是标准答案。它内部自动记录着当前存储的是哪种类型,并在你访问时做运行时检查,从根源上杜绝了类型误判。
这里需要特别注意区分:它可不是 std::any。后者只负责存“任意类型”,对类型没有任何限制;而 std::variant 必须在编译期就明确列出所有可能的类型,比如 std::variant。这种设计给了编译器极大的优化空间,也让你的代码意图更加清晰。
std::get 和 std::get 的区别与误用风险
std::get 有两种重载形式,容易被混淆,需要心里有数:
std::get:按类型提取。如果(v) v当前不持有T类型,就会抛出std::bad_variant_access异常。std::get(v):按索引提取(I是编译期整型常量,从0开始)。如果I超出了变体类型列表的长度,编译直接报错;但即便索引合法,如果当前值不是该索引对应的类型,同样会抛出异常。
容易踩的坑有哪些?
- 对包含重复类型的
std::variant(比如std::variant)使用std::get—— 编译失败,因为类型不唯一。 - 不检查
v.index()或std::holds_alternative,就直接调用(v) std::get—— 运行时崩溃。(v) - 把
std::get<0>(v)当作“取第一个值”的万能操作,却忽略了索引对应的是声明顺序,而不是值插入顺序。
安全访问 std::variant 的三种常用方式
先说结论:在线上代码里,别裸写 std::get。更推荐的做法是:
- 先用
std::holds_alternative判断是否持有类型(v) T,再调用std::get。这是最朴素但最安全的方式。(v) - 用
std::visit+ lambda 处理所有分支。这种方式天然覆盖所有情况,编译器会强制你处理每一种类型,一个都不会漏。 - 对简单场景,也可以用
v.index()做分支切换。但要注意:索引值依赖模板参数的声明顺序,一旦重构类型列表,语义就会悄悄改变,容易引发隐蔽的bug。
最推荐的方式是 std::visit,看个例子:
std::variantv = "hello"; std::visit([](const auto& x) { using T = std::decay_t ; if constexpr (std::is_same_v ) { std::cout << "int: " << x << "\n"; } else if constexpr (std::is_same_v ) { std::cout << "string: " << x << "\n"; } else if constexpr (std::is_same_v ) { std::cout << "double: " << x << "\n"; } }, v);
std::variant 的移动语义和异常安全性细节
std::variant 默认构造时处于“值初始化”状态,也就是用第一个类型的默认构造函数初始化。但有一点需要特别警惕:只声明而从未赋值的 std::variant,访问它属于未定义行为。
几个关键点值得记住:
- 赋值或 emplace 后,旧值会被正确析构,前提是该类型的析构函数不抛异常。
- 如果某个备选类型的构造函数或赋值运算符抛出了异常,
std::variant会保证自身处于一个有效但未指定的状态。此时v.valueless_by_exception() == true,任何std::get调用都会抛出std::bad_variant_access。 - 一旦 variant 进入
valueless_by_exception()状态,绝对不要对它做任何访问操作。必须先重置,比如v.emplace(42)。
一个容易被忽略的细节是:即便你只用了 int 和 std::string 两种类型,只要其中一个类型的构造可能抛异常(比如 std::string 的内存分配失败),整个 variant 的赋值就不再是 noexcept 的。这在实际编码中是需要留意的。