根本原因是 yaml-cpp 默认不识别 eigen 类型，必须手动特化 yaml::convert，正确实现 encode/decode 并做尺寸校验与异常捕获，且 yaml 输入须为 list of lists 结构。

yaml-cpp 读取矩阵时为什么总是报 BadConversion？

根本原因是 yaml-cpp 默认不识别 Eigen 类型，你直接写 node.as<:matrixxd>()</:matrixxd> 就会炸——它连 Eigen::MatrixXd 是个啥都不知道，更别说怎么从 YAML 节点反序列化了。

必须手动注册类型转换器。这不是“配置一下就能用”的功能，而是要显式告诉 yaml-cpp：“遇到这种 YAML 结构，请按我写的规则转成 Eigen 矩阵”。

• 别在 YAML::convert<:matrixxd></:matrixxd> 外面套命名空间（比如 namespace YAML { ... }），否则模板特化可能不生效
• YAML 中矩阵得是标准二维结构：每行一个 list，整体是 list of lists，不能用 map 或嵌套 key
• node.size() 返回的是行数，每行再调 row_node.size() 得列数；如果某行长度不一致，你得自己检查，yaml-cpp 不报错但结果错乱

如何为 Eigen::MatrixXd 写安全的 YAML::convert 特化？

核心是重载 encode() 和 decode()，且 decode 必须做边界防护——因为 YAML 输入不可信。

示例特化片段（放在头文件或 .cpp 开头）：

C++ Code Review Master

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

下载

namespace YAML {
template
struct convert<:matrixxd> {
    static Node encode(const Eigen::MatrixXd& rhs) {
        Node node;
        for (int i = 0; i static bool decode(const Node& node, Eigen::MatrixXd& rhs) {
    if (!node.IsSequence()) return false;
    if (node.size() == 0) {
        rhs = Eigen::MatrixXd(0, 0);
        return true;
    }
    const size_t rows = node.size();
    const size_t cols = node[0].IsSequence() ? node[0].size() : 0;
    if (cols == 0) return false;

    rhs.resize(rows, cols);
    for (size_t i = 0; i < rows; ++i) {
        if (!node[i].IsSequence() || node[i].size() != cols) return false;
        for (size_t j = 0; j < cols; ++j) {
            try {
                rhs(i, j) = node[i][j].as<double>();
            } catch (const YAML::BadConversion&) {
                return false;
            }
        }
    }
    return true;
}</:matrixxd>

}; }

• 必须用 double 接数值（Eigen::MatrixXd 是 double 类型），别用 float 或 int，否则 as() 会抛异常
• encode() 不检查 NaN/Inf，但 decode() 里没做校验——如果 YAML 含 .nan 或 <.inf><double></double>

• <float></float>
• <int></int><double></double><int></int>

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！