std::any_cast是唯一安全提取std::any值的方式，它通过类型检查避免未定义行为：拷贝版和引用版失败抛bad_any_cast异常，指针版返回nullptr；不支持隐式转换，要求类型完全匹配且完整定义。

直接说结论：std::any_cast 是唯一安全提取 std::any 中值的方式，它不叫 std::any_cast_c++17 —— 那个名字不存在，是常见误解或拼写错误。

为什么不能直接用 any.value() 或强制转型？

std::any 是类型擦除容器，内部存储的值类型在编译期不可知。没有 .value() 成员函数；也不能用 static_cast 或 C 风格转换强行取值——这会触发未定义行为（UB），程序可能崩溃或静默出错。

必须通过 std::any_cast 进行带类型检查的提取：

• 若类型匹配，返回引用或拷贝值
• 若类型不匹配，抛出 std::bad_any_cast 异常（对引用/指针版本）或返回空指针（对指针重载）

std::any_cast 的三种重载形式怎么选？

关键看你要“取值”还是“判存”，以及是否愿意处理异常：

立即学习“C++免费学习笔记（深入）”；

• std::any_cast(any_obj)：尝试提取为 T 类型的**拷贝**（T 必须可拷贝）。失败则抛 std::bad_any_cast
• std::any_cast(any_obj)：提取为 T 的**左值引用**。失败同样抛异常
• std::any_cast(any_obj)：返回 T* 指针。类型不匹配时返回 nullptr，**不抛异常**，适合做类型探测

注意：所有重载都要求 T 是完整类型（不能是前置声明类）；且 std::any_cast 本身是函数模板，编译器需能推导或你显式指定 T。

常见错误：const、引用、cv 限定符不匹配

类型必须完全一致（含 const/volatile 和引用性）。例如：

std::any a = std::string("hello");
std::string s1 = std::any_cast(a);        // ✅ 拷贝构造
std::string& s2 = std::any_cast(a);     // ✅ 引用
const std::string& s3 = std::any_cast(a); // ✅ const 引用
std::any_cast(std::as_const(a));         // ❌ 编译失败：a 是 const any，无法转非 const 引用
std::any_cast(std::move(a));              // ✅ 可以，但 a 变为空（已转移）

容易踩坑的是：把 std::any 存了 int，却用 std::any_cast 去取——即使 int 能隐式转 long，std::any_cast 也**不做隐式转换**，只做精确类型匹配。

性能与使用建议

std::any_cast 的运行时开销极小：本质是对比内部 type_info，无内存分配。但频繁 cast 可能说明设计上过度依赖类型擦除，应考虑更静态的替代方案（如 std::variant）。

实用建议：

• 优先用指针重载（if (auto p = std::any_cast(&a)) { ... }）避免异常开销
• 不要对空 std::any（即 a.has_value() == false）调用非指针版 any_cast，否则一定抛异常
• 跨模块传递 std::any 时，确保类型定义在头文件中可见，否则 any_cast 可能因 ODR 违规导致未定义行为

最易被忽略的一点：std::any 不支持不完整类型（如仅声明未定义的 class），而 std::any_cast 对类型的依赖是硬性的——哪怕只是想 cast 成指针，该类型也必须完整定义。

https://www.php.cn/faq/2005448.html