C++如何使用std::any-C++-PHP中文网

std::any专为运行时类型不确定但需安全持有的场景设计，支持可复制或可移动的完整类型（如int、std::string），禁用void、引用、数组等；取值须用std::any_cast严格匹配类型，推荐指针版本防异常；适用配置解析、插件传参等，非万能容器，不替代std::variant。

c++如何使用std::any

std::any 用来存什么类型的数据

它专为「运行时类型不确定但需要安全持有」的场景设计，比如配置项解析、插件系统传参、反射中间值。不能存 void、引用、const 成员函数指针这类不可复制/不可移动的类型；也不能直接存数组（如 int[3]），得转成 std::array 或 std::vector。

常见错误现象：构造时传入临时对象却忘了移动，导致意外拷贝——尤其对大对象（如 std::string）影响性能；或者用 std::any_cast 强转类型失败后没检查，程序直接抛 std::bad_any_cast 异常。

支持所有可复制或可移动的类型（包括自定义类，只要满足 CopyConstructible 或 MoveConstructible）
内部存储会根据值大小选择栈上缓存（small buffer optimization）或堆分配，无需手动管理内存
若存的是右值，优先调用移动构造，避免深拷贝

如何安全地取出 std::any 里的值

必须用 std::any_cast，且类型必须完全匹配——连 const 和引用修饰符都要一致。比如存了 int，就不能用 std::any_cast<const int></const> 直接取，除非原值就是 const int。

推荐始终用指针版本的 std::any_cast 做空值检查，避免异常中断流程：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

std::any data = 42;
if (auto p = std::any_cast<int>(&data)) {
    // 安全使用 *p
} else {
    // 类型不匹配，处理错误
}</int>

std::any_cast<t>(any&)</t>：成功返回 T&，失败抛 std::bad_any_cast
std::any_cast<t>(const any&)</t>：返回 const T&，同样可能抛异常
std::any_cast<t>(&any)</t>：返回 T*，失败返回 nullptr，最安全

std::any 和 std::variant 哪个该用

关键看类型集合是否已知且有限：std::variant 要求编译期枚举所有可能类型（如 std::variant<int double std::string></int>），内存布局紧凑、无动态分配、访问快；std::any 不限制类型数量，但每次访问都要运行时类型比对，有额外开销。

典型误用：用 std::any 存固定几种类型（比如只在 int/double/bool 间切换），这反而失去类型安全和性能优势。

选 std::any：插件参数、用户输入泛化存储、DSL 解析中间结果
选 std::variant：状态机状态值、JSON 基础类型映射、协议字段解析
两者不能混用：不能把 std::any 当 std::variant 的替代品来“绕过类型约束”

std::any 的生命周期和线程安全要注意什么

它本身是可复制、可移动的，但内部持有的对象的线程安全性由该对象自己决定。比如存了一个 std::shared_ptr<myclass></myclass>，那线程安全取决于 MyClass 是否线程安全；而 std::any 的赋值、移动操作是线程安全的（符合 C++17 中对可复制类型的最低要求）。

容易被忽略的一点：如果把 std::any 存进容器（如 std::vector<:any></:any>），再用 emplace_back 插入大对象，可能触发多次重分配和移动——建议预留容量，或考虑用 std::any 持有智能指针来减少搬运成本。