Eigen打印DiagonalMatrix遇ostream运算符错误，求问题排查方案

问题重现 #

编写的代码 #

#include <iostream>
#include <eigen3/Eigen/Core>
#include <eigen3/Eigen/Dense>

int main(){
    Eigen::DiagonalMatrix<double, 3> M(3.0, 8.0, 6.0);
    std::cout << M << std::endl;
    return 0;
}

编译错误信息 #

error: invalid operands to binary expression ('std::ostream' (aka 'basic_ostream<char>') and 'Eigen::DiagonalMatrix<double, 3>')
  std::cout << M << std::endl;
  ~~~~~~~~~ ^  ~
/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX13.0.sdk/usr/include/c++/v1/cstddef:143:3: note: candidate function template not viable: no known conversion from 'std::ostream' (aka 'basic_ostream<char>') to 'std::byte' for 1st argument
  operator<< (byte  __lhs, _Integer __shift) noexcept
  ^
/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX13.0.sdk/usr/include/c++/v1/ostream:748:1: note: candidate function template not viable: no known conversion from 'Eigen::DiagonalMatrix<double, 3>' to 'char' for 2nd argument
operator<<(basic_ostream<_CharT, _Traits>& __os, char __cn)
^
/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX13.0.sdk/usr/include/c++/v1/ostream:781:1: note: candidate function template not viable: no known conversion from 'Eigen::DiagonalMatrix<double, 3>' to 'char' for 2nd argument
operator<<(basic_ostream<char, _Traits>& __os, char __c)
^

使用的CMakeLists.txt #

cmake_minimum_required(VERSION 3.0)

project(ExternalLib CXX)

set(CMAKE_CXX_STANDARD 17)

find_package(Eigen3 REQUIRED)

add_executable(out main.cpp)
target_link_libraries(main PUBLIC)

问题原因 #

1. 头文件路径错误：
   代码中用#include <eigen3/Eigen/Core>的方式引入头文件，但find_package(Eigen3 REQUIRED)已经将Eigen的根目录（如/usr/include/eigen3）加入编译的include路径，正确的引入方式应为#include <Eigen/Core>。错误的路径会导致头文件嵌套异常，部分核心功能（如流输出运算符）无法正确加载。

2. CMake配置错误：

   • 可执行文件定义为out，但后续target_link_libraries引用的目标名是main，两者不匹配，导致Eigen的依赖配置未关联到正确目标。
   • 未正确关联Eigen依赖，需要通过Eigen3::Eigen目标确保include路径和编译选项正确应用。

3. DiagonalMatrix无直接流输出支持：
   Eigen的DiagonalMatrix类未直接重载std::ostream的operator<<，无法直接输出到控制台，需要转换为稠密矩阵后再输出。

修复方案 #

修正后的代码 #

#include <iostream>
#include <Eigen/Core>
#include <Eigen/Dense>

int main(){
    Eigen::DiagonalMatrix<double, 3> M(3.0, 8.0, 6.0);
    // 转换为稠密矩阵后输出
    std::cout << M.toDenseMatrix() << std::endl;
    return 0;
}

修正后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.0)

project(ExternalLib CXX)

set(CMAKE_CXX_STANDARD 17)

find_package(Eigen3 REQUIRED)

add_executable(out main.cpp)
// 关联Eigen官方提供的目标，自动处理依赖
target_link_libraries(out PUBLIC Eigen3::Eigen)

修复说明 #

• 去掉头文件路径中的eigen3/前缀，利用find_package提供的路径正确加载Eigen头文件。
• 修正CMake中的目标名，通过Eigen3::Eigen目标自动关联Eigen的include路径，无需手动配置。
• 调用toDenseMatrix()将对角矩阵转换为稠密矩阵类型，即可使用Eigen的流输出功能。

内容的提问来源于stack exchange，提问作者QualsPassed