std::monostate 是专为 std::variant 设计的零大小默认可构造占位类型,用于显式表示“未初始化”状态;它不携带数据、无可比较性,仅通过 std::holds_alternative 安全识别,且不增加 variant 内存开销。

std::monostate 是 std::variant 的合法空状态类型
在 std::variant 中,不能定义“不含任何值”的实例(即没有默认构造出“空”状态),除非你显式提供一个可默认构造的类型作为其第一个备选项。而 std::monostate 就是标准库为此专门设计的“零大小、无状态、仅用于占位”的类型——它不携带数据、不比较相等、不参与逻辑判断,唯一作用就是让 std::variant 合法地拥有一个默认构造状态。
常见错误现象:
std::variant<int, std::string> v; // 编译失败!因为 int 和 std::string 都不是默认可构造的?错:int 是默认可构造的,但问题在于——std::variant 默认构造时会尝试默认构造其第一个类型(int),这没问题;但如果你写的是 std::variant<std::string, int>,而 std::string 默认构造是 OK 的,所以也 OK。真正需要 monostate 的场景是:你想让 variant 明确表达“尚未赋值”或“无效状态”,且不希望误用某个业务类型(比如用 0 表示 int 的“空”)来模拟空值。
-
std::monostate大小为 0,无成员,无比较操作符(operator==等需用户自定义),只支持赋值和销毁 - 它被设计为
std::variant的“哑占位符”,语义上代表“此处无有效值”,而非业务意义上的某个状态 - 若你把
std::monostate放在std::variant列表首位(如std::variant<:monostate int std::string></:monostate>),则默认构造后其index()返回0,且std::holds_alternative<:monostate>(v)</:monostate>为true
为什么不用 std::nullopt 或 void?
std::nullopt_t 不是可构造/可存储类型(它是字面量类型,不可实例化变量),不能作为 std::variant 的模板参数;void 更不行——根本不是对象类型。只有满足“可默认构造 + 可析构 + 可复制/移动”的类型才能进 std::variant,而 std::monostate 正是为此定制的最小合规类型。
-
std::monostate{}是合法表达式,能绑定到const std::monostate&,能存入std::variant -
std::nullopt是std::nullopt_t类型的常量,但std::nullopt_t没有默认构造函数,无法出现在 variant 模板参数列表中 - 试图写
std::variant<void int></void>直接编译失败:error: ‘void’ is not a valid type for a variant alternative
实际使用中怎么判断和切换空状态?
关键不是“怎么创建”,而是“怎么安全识别和处理”。std::monostate 本身不提供语义,你需要靠 std::holds_alternative 或 std::visit 显式分支处理。
立即学习“C++免费学习笔记(深入)”;
std::variant<std::monostate, int, std::string> v;
// 默认构造 → 持有 std::monostate
assert(v.index() == 0);
assert(std::holds_alternative<std::monostate>(v));
// 赋值后切换
v = 42;
assert(v.index() == 1);
assert(std::holds_alternative<int>(v));
// 使用 visit 处理所有情况(含 monostate)
std::visit([](const auto& x) {
using T = std::decay_t<decltype(x)>;
if constexpr (std::is_same_v<T, std::monostate>) {
// 这里处理“空”逻辑:日志、跳过、报错等
std::cout << "uninitialized\n";
} else if constexpr (std::is_same_v<T, int>) {
std::cout << "int: " << x << "\n";
} else if constexpr (std::is_same_v<T, std::string>) {
std::cout << "string: " << x << "\n";
}
}, v);
- 永远不要依赖
v.index() == 0来判断空——如果以后把std::monostate移到第二位,逻辑就崩了;应始终用std::holds_alternative<:monostate>(v)</:monostate> - 不要对
std::monostate做任何解引用或转型操作:它没有value()、没有get()成员,强行调用会编译失败 - 性能上无开销:
std::monostate不增加std::variant的大小,也不影响访问速度
替代方案对比:optional> vs variant
有人会想:我直接套一层 std::optional<:variant std::string>></:variant> 不也能表示“空”吗?可以,但语义和成本不同。
-
std::optional<t></t>额外占用 1 字节(对齐后可能更多)存储 has_value 标志;std::variant<:monostate ...></:monostate>把“空”当作一种合法替代项,复用已有 index 字段,空间更紧凑 -
std::optional<:variant>></:variant>是两层嵌套:先判 optional 是否有值,再判 variant 持有哪个类型;而单层 variant + monostate 只需一次std::visit或std::holds_alternative - 但注意:
std::monostate不等于 “错误/异常状态”——它只是“未初始化”,不代表操作失败。若需区分“未设置”和“设置失败”,仍应引入额外类型(如std::expected)
最易被忽略的一点:monostate 不提供任何调试线索。一旦 variant 持有它,你完全不知道它为何为空——是初始化遗漏?路径未覆盖?还是故意预留?必须配合上下文或额外标记(比如封装成类,加状态字段)才能避免误用。










