如何在C++中使用 std::variant 实现类型安全的多态

在现代 C++（C++17 及以后）中，std::variant 提供了一种优雅且类型安全的方式来处理多种可能类型的数据。与传统的继承+虚函数或 union + enum 组合相比，std::variant 更加灵活、可读性更高，也能在编译期捕获错误。本文将从概念、用法、优势以及常见坑四个角度，全面剖析如何在 C++ 项目中利用 std::variant 进行类型安全的多态实现。

一、`std::variant` 基础

std::variant 是一个可变类型容器，它能够在运行时存放若干指定类型中的任意一种。与 std::any 相比，std::variant 的类型集合是固定且有限的，编译器能检查所有可能的类型，从而避免了运行时错误。

1. 声明与初始化

#include <variant>
#include <string>
#include <iostream>

using Var = std::variant<int, double, std::string>;

int main() {
    Var v1 = 42;              // int
    Var v2 = 3.14;            // double
    Var v3 = std::string("hello"); // std::string
}

2. 访问值

**`std::get `**：若当前值不是 `T`，会抛 `std::bad_variant_access`。
**`std::get_if `**：返回指针，若不是 `T` 则返回 `nullptr`。
std::visit：访问器，接受一个可调用对象（函数、lambda 或者 std::visit），根据当前值的实际类型调用对应的重载。

std::visit([](auto&& arg) {
    std::cout << "value: " << arg << "\n";
}, v1);

二、实现多态逻辑

传统多态通过继承+虚函数实现，但常伴随多重继承、虚表等隐性成本。std::variant 可以让我们在编译期就确定所有可能的类型，从而消除虚函数的运行时开销。

1. 简单多态案例

假设我们需要处理形状（圆、矩形、三角形），并分别计算面积。

struct Circle { double radius; };
struct Rect   { double width, height; };
struct Triangle { double a, b, c; };

using Shape = std::variant<Circle, Rect, Triangle>;

double area(const Shape& s) {
    return std::visit(overloaded{
        [](const Circle& c){ return 3.141592653589793 * c.radius * c.radius; },
        [](const Rect& r){ return r.width * r.height; },
        [](const Triangle& t){ 
            double s = (t.a + t.b + t.c) / 2.0;
            return std::sqrt(s * (s - t.a) * (s - t.b) * (s - t.c));
        }
    }, s);
}

这里使用了 overloaded，一个辅助模板用于组合多个 lambda：

template<class... Ts> struct overloaded : Ts... { using Ts::operator()...; };
template<class... Ts> overloaded(Ts...) -> overloaded<Ts...>;

2. 高级组合：`std::variant` 与 `std::optional`

有时我们需要“可空”多态类型，即可能不存在值。可以将 std::variant 包装在 std::optional 中：

using OptShape = std::optional <Shape>;

这样既保留了类型安全，又能表达“未定义”状态。

三、优势与注意事项

1. 优势

传统方式	`std::variant`
需要继承层次，易产生二义性	类型集合固定，编译期检查
运行时虚表开销	无虚表，栈上存储（若尺寸适中）
难以安全转换	`std::visit` 自动匹配
需要 RTTI 或手工 `dynamic_cast`	无 RTTI 依赖
可能出现“悬挂指针”	`std::variant` 确保值有效

2. 注意事项

尺寸限制：std::variant 内部实现是一个 union，其大小等于最大成员的大小加上必要的对齐。若成员过大（如大型容器），会导致堆栈占用过大。可使用 std::variant<std::shared_ptr<...>> 或 std::unique_ptr 进行包装。
递归类型：递归 std::variant 需要使用 std::shared_ptr 或 std::unique_ptr 包装，以避免无限嵌套。
异常安全：在 std::visit 过程中，如果 lambda 抛异常，variant 仍保持原值。确保访问逻辑是异常安全的。
多态性能：虽然 variant 避免了虚表，但 std::visit 仍涉及函数指针调用（若使用函数表实现）。在极端性能要求场景下，需要评估是否真正受益。

四、实战示例：简易表达式求值

下面用 std::variant 实现一个支持整数、浮点数、变量、加法、乘法的表达式树。

#include <variant>
#include <string>
#include <unordered_map>
#include <iostream>
#include <memory>

struct IntExpr { int value; };
struct DoubleExpr { double value; };
struct VarExpr { std::string name; };

struct AddExpr;
struct MulExpr;

using Expr = std::variant<IntExpr, DoubleExpr, VarExpr, std::shared_ptr<AddExpr>, std::shared_ptr<MulExpr>>;

struct AddExpr { Expr left, right; };
struct MulExpr { Expr left, right; };

double eval(const Expr& e, const std::unordered_map<std::string,double>& vars) {
    return std::visit(overloaded{
        [](const IntExpr& i){ return static_cast <double>(i.value); },
        [](const DoubleExpr& d){ return d.value; },
        [&](const VarExpr& v){ return vars.at(v.name); },
        [&](const std::shared_ptr <AddExpr>& a){ return eval(a->left, vars) + eval(a->right, vars); },
        [&](const std::shared_ptr <MulExpr>& m){ return eval(m->left, vars) * eval(m->right, vars); }
    }, e);
}

使用示例：

int main() {
    Expr expr = std::make_shared <MulExpr>(Expr{std::shared_ptr<AddExpr>(new AddExpr{IntExpr{3}, VarExpr{"x"}})},
                                           Expr{DoubleExpr{2.5}});
    std::unordered_map<std::string,double> vars{{"x", 4}};
    std::cout << "Result: " << eval(expr, vars) << "\n"; // (3 + 4) * 2.5 = 17.5
}

五、结语

std::variant 为 C++ 提供了一种现代且安全的多态实现方式。它在保持类型安全的前提下，消除了传统多态带来的隐藏成本和错误。只要注意尺寸、递归以及异常安全，std::variant 能让代码更加简洁、易维护，并在性能方面获得潜在提升。希望本篇文章能帮助你在实际项目中灵活运用 std::variant，构建更加健壮的 C++ 代码。

一、std::variant 基础