简介Eigen 3.3.3 是一份面向 C 开发者的线性代数库源码压缩包广泛用于矩阵与向量运算、稀疏求解、几何变换等数值计算场景。这份资源基于 eigen-3.3.3 官方源码整理共包含 2000 个文件容量约 9.74MB主体为 .h/.hh 头文件与模板实现另配有大量 make、cmake 构建脚本、cpp/cu 示例程序、txt 说明文档以及 json 配置文件便于在 CMake 或 Make 工程中快速引用。作为纯头文件库Eigen 无需预编译和链接解压后把 Eigen 目录加入项目包含路径即可直接使用这对需要离线安装包的开发者非常方便。包内还保留了 dox 文档和单元测试样例可辅助理解矩阵乘法、特征值分解等核心接口。资源已获得 681 人学习下载适合希望在本地搭建 Eigen 开发环境或快速上手线性代数运算的工程师选用。 搞机器人、视觉SLAM或者点云处理的朋友估计没少跟Eigen打交道。它就是那个让你用一行代码完成矩阵逆运算、SVD分解、特征值计算的C模板库号称“下载解压就能用”。但问题恰恰出在这个“下载解压”上网上教程绝大多数都在讲最新版3.4.x可很多老项目比如ORB-SLAM2、VINS-Mono明确锁定了eigen 3.3.3版本安装包照着新版教程操作CMake配置和头文件路径经常对不上一不小心就编译报错。这篇博文就围绕eigen 3.3.3版本安装包来写把Windows、Linux、macOS三平台的下载安装、CMake集成、版本校验和常见坑一次说清楚。不管你是刚入门C的小白还是被老项目折腾到头疼的开发者照着操作都能装上并跑通。1. 先搞清楚Eigen 3.3.3 到底是一个什么样的包很多人在第一步就迷糊了因为Eigen的“安装”和普通库的“安装”完全不是一个概念。这直接决定了你后续所有操作的方式。1.1 纯头文件库下载解压就已经“装完一半”Eigen是一个header-only的模板库也就是说它的源码全部由.h头文件组成没有.so、没有.dll、没有.a也不需要单独编译成二进制文件。编译器在编译你的代码时会直接把Eigen的模板实现展开到你的程序里。用生活来类比普通库安装像是买一台整机插上电源就能用而Eigen更像拿到一箱零件最关键的“组装图纸”就在头文件里编译时自动拼装。所以“安装eigen 3.3.3”本质上只做两件事获取eigen 3.3.3源码包让编译工具编译器、CMake、IDE能找到它include目录下的头文件这就导致很多人第一次安装时产生一个困惑“我make install了为什么没有生成库文件”——根本没有库文件可生成你安装的是头文件和CMake配置文件。但细节上还是有讲究的。源码包解压后你会看到Eigen目录注意大小写Linux下严格区分和unsupported目录。Eigen是官方稳定模块unsupported是实验性模块比如FFT、多项式、样条。CMake配置时要特别注意include路径要指到包含Eigen目录的上一级而不是直接指到Eigen文件夹里面。我见过太多人把路径写成include/Eigen结果编译器死活找不到#include Eigen/Core。1.2 为什么老项目都把版本锁死在 3.3.3Eigen 3.3.3发布于2017年在3.3系列里算是承上启下的版本。它的API接口非常稳定后续3.3.4到3.3.7基本都是修bug和做编译兼容性优化功能上变化不大。很多经典开源项目在2017到2019年间活跃维护就把依赖锁在了这个版本上。3.3.3版相比早期版本有几个核心变化改进了向量化代码生成对SSE/AVX指令集支持更成熟优化了矩阵求逆和线性求解器性能提供了更完善的C11支持修复了此前版本中部分内存对齐导致的崩溃问题表格对比3.3系列常见版本版本发布时间核心特点适用场景3.3.12016年3.3系列首个稳定版老教程、老系统3.3.32017年接口稳定、兼容性好大量视觉SLAM项目锁定此版本3.3.42017年修复3.3.3若干编译期bug需要小修版本再升级3.3.72018年3.3系列最终版兼容性最佳无明显理由时的稳妥选择这里有个很实际的场景Ubuntu 18.04通过apt默认安装的libeigen3-dev就是3.3.4Ubuntu 20.04自带3.3.7也就是说用包管理器安装大概率装不到3.3.3。如果你跟我一样遇到“项目文档明确写了要求Eigen 3.3.3编译时却提示版本不匹配”那大概率就是包管理器版本和项目要求对不上。2. 动手安装三种主流安装方式与平台适配搞清楚了Eigen的header-only属性接下来就是实操。我按平台来拆每个平台给一个最稳妥的方案。2.1 Windows解压即用关键是路径别放错Windows下最省事的方式就是下载官方release的zip压缩包然后解压到一个固定目录。步骤很简单去官方发布页找到3.3.3版本的zip包解压到某个无中文、无空格的路径例如D:\libs\eigen-3.3.3在Visual Studio的项目属性里把D:\libs\eigen-3.3.3添加到“C/C → 常规 → 附加包含目录”代码里直接#include Eigen/Core就可以编译如果你用CMake那更简单在CMakeLists.txt里加上include_directories(D:/libs/eigen-3.3.3)或者用find_package(Eigen3 REQUIRED)后面详讲。Windows下的两个坑要重点说第一路径别带空格和中文。有人把Eigen解压到C:\Program Files (x86)\eigen 3.3.3结果CMake的find_package解析路径时被空格搞崩溃折腾半天还以为是Eigen和VS不兼容。第二zip包解压后有个顶层目录比如eigen-eigen-5a0156e40feb这种带哈希后缀的这个哈希目录名没有固定规律解压后要么重命名成eigen-3.3.3要么在配置时找准路径。我见过有个同事把哈希目录名原封不动写进CMakeLists结果换一台电脑解压哈希变了路径又失效浪费时间。2.2 Linux源码编译安装与包管理器安装二选一Linux下有两种安装方式思路完全不同。方式一源码编译安装精确版本推荐wget https://github.com/eigenteam/eigen-git-mirror/archive/refs/tags/3.3.3.tar.gz tar -xzf 3.3.3.tar.gz cd eigen-git-mirror-3.3.3 mkdir build cd build cmake .. sudo make install执行完后头文件会安装到/usr/local/include/eigen3CMake配置文件会安装到/usr/local/share/eigen3/cmake/。这个方式的优点是指定版本精确、不会污染系统目录缺点是稍微多敲几条命令。方式二apt安装不推荐用于锁定版本sudo apt install libeigen3-devapt安装速度快、依赖管理省心但是版本完全由系统仓库决定。Ubuntu 18.04装出来是3.3.4Ubuntu 20.04是3.3.7你想要3.3.3根本选不了。所以项目明确要求3.3.3时老老实实用源码安装。这里多提一句源码安装里面的细节Eigen官方在构建时其实可以跳过build目录直接执行make install但官方文档推荐用out-of-source构建也就是先建一个build目录在里面执行CMake。原因是CMake会在源码目录生成一堆缓存文件和临时产物Eigen是纯模板库还好如果是其他项目会污染源码树。养成这个习惯以后编译其他库也能少吃点亏。2.3 macOSHomebrew与源码方式二选一macOS上最省力的方式是Homebrewbrew install eigen安装完成后终端会提示头文件路径在/opt/homebrew/include/eigen3Apple Silicon或/usr/local/include/eigen3Intel版。这种方式装到的版本取决于Homebrew仓库当前维护的版本要精确装3.3.3可以查看历史版本然后直接用源码编译方式跟Linux一样就是下载tar.gz、解压、cmake、make install一套流程。我在macOS上踩过一个小坑Homebrew安装的Eigen可能不是最新也是较新的但某些老项目编译时不看版本号只认路径结果代码里写的是老API新版本虽然兼容但行为有细微差别。所以如果你在Mac上编译老项目最稳妥的还是下载3.3.3源码包手动安装。2.4 header-only带来的“伪安装”现象这里要单独澄清一个问题很多人执行完源码安装后发现/usr/local/lib目录下并没有新增任何库文件就以为安装失败了。实际上这是正常的我用一行命令说明Eigen安装的最终结果/usr/local/include/eigen3/Eigen/Core /usr/local/share/eigen3/cmake/Eigen3Config.cmakeEigen安装完毕后主要产物就是头文件目录和一个CMake配置文件。没有二进制库文件。所以当你用ldconfig或者ls /usr/local/lib检查时看不到东西不代表安装有问题。3. CMake工程集成让编译器找到头文件安装只是第一步真正让工程跑起来的是CMake配置。Eigen在CMake里的集成方式非常灵活但也很容易写错。3.1 find_package 正确用法与 EXACT 精确匹配最规范的写法是cmake_minimum_required(VERSION 3.10) project(eigen_demo) set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(Eigen3 3.3 REQUIRED NO_MODULE) add_executable(demo main.cpp) target_link_libraries(demo Eigen3::Eigen)注意几个点NO_MODULE是为了使用Eigen3Config.cmake这种现代CMake的package配置模式而不是老的FindEigen3.cmake模块模式。如果你不加NO_MODULECMake会优先搜索FindEigen3.cmake而老模块里获取的变量名是EIGEN3_INCLUDE_DIR写法完全不同。版本号写3.3表示要求3.3及以上版本如果你一定要精确3.3.3可以加EXACT参数find_package(Eigen3 3.3.3 EXACT REQUIRED NO_MODULE)这样CMake找到的版本只要不是3.3.3就会直接报错从底层杜绝“装错版本”的问题。如果不想用find_package也可以用最粗暴的include_directoriesinclude_directories(/usr/local/include/eigen3)这种写法的优点是简单直观缺点是换环境就得改路径也不方便版本管理。我建议新项目用Eigen3::Eigen目标方式老项目如果原本就是include_directories风格没必要瞎折腾保持原样就好。3.2 一个可直接编译的矩阵运算 Demo写一个最简单的Demo用来验证Eigen安装是否成功代码内容就是输出Eigen版本号并做一次矩阵乘法。#include iostream #include Eigen/Dense int main() { std::cout Eigen version: EIGEN_WORLD_VERSION . EIGEN_MAJOR_VERSION . EIGEN_MINOR_VERSION std::endl; Eigen::Matrix3d A; A 1, 2, 3, 4, 5, 6, 7, 8, 10; Eigen::Vector3d b(1, 2, 3); Eigen::Vector3d x A.colPivHouseholderQr().solve(b); std::cout Solution x:\n x std::endl; return 0; }编译并运行mkdir build cd build cmake .. make ./demo输出类似这样Eigen version: 3.3.3 Solution x: -0.333333 0.666667 0看到Eigen version: 3.3.3就说明安装和集成全部正常。3.3 编译期版本验证三件套除了上面Demo里的宏输出还有几种验证版本的方式按场景不同选择看宏EIGEN_WORLD_VERSION、EIGEN_MAJOR_VERSION、EIGEN_MINOR_VERSION三个宏组合出来的数字就是当前生效的版本。这是最直接的方式编译期就能看到。看CMake变量find_package成功后可以通过${Eigen3_VERSION}变量拿到版本号在CMakeLists里message(STATUS found Eigen version: ${Eigen3_VERSION})打印出来。看头文件路径编译器加-H参数或者-E -dM预处理输出能列出实际包含的头文件绝对路径排查多版本污染时非常好用。版本验证这一步千万别省。很多时候你以为装的是3.3.3实际因为环境变量PATH、CMake缓存、系统目录干扰编译用的根本不是同一个版本排查起来会异常痛苦。4. 常见问题与避坑实录最后这部分是我实际折腾Eigen时遇到的最多的坑整理成一个速查表另外每个问题展开说一下排查思路。4.1 多版本共存头文件路径污染怎么破场景是这样你自己源码编译了一个3.3.3到/usr/local/include/eigen3同时apt也装了一个3.3.7在/usr/include/eigen3。CMake的find_package搜索路径通常按“当前项目优先 → 用户目录 → 系统目录”的顺序但很多老项目的CMakeLists里又同时存在include_directories和find_package两个路径打架最终编译器可能用了/usr/include/eigen3里的3.3.7头文件。排查命令特别简单grep -R EIGEN_MINOR_VERSION /usr/include/eigen3/Eigen/src/Core/util/Macros.h grep -R EIGEN_MINOR_VERSION /usr/local/include/eigen3/Eigen/src/Core/util/Macros.h分别看看系统目录和用户目录里各自是什么版本。如果确实存在多版本解决方案有三个卸载apt安装的eigensudo apt remove libeigen3-dev用CMake的CMAKE_IGNORE_PATH排除特定搜索目录在CMakeLists里显式include_directories(BEFORE /usr/local/include/eigen3)让用户目录优先我个人的习惯是把所有个人编译的库都装在/usr/local系统包管理器装的一律不用然后通过CMake的NO_DEFAULT_PATH限制搜索范围一劳永逸。4.2 对齐断言与编译报错Eigen在3.3.x时代对内存对齐要求很高尤其是固定尺寸的向量和矩阵比如Vector4d、Matrix2d如果你在类里直接定义Eigen对象作为成员变量并且用STL容器存放固定尺寸Eigen类型很容易触发类似下面的编译断言static assertion failed: YOU_MIXED_VECTORS_OF_DIFFERENT_SIZES或者运行期崩溃报错和unaligned相关。解决办法有三个在类成员里添加EIGEN_MAKE_ALIGNED_OPERATOR_NEW宏使用Eigen::aligned_allocator替代std::allocator如果你确定不需要向量化加速可以在编译选项里加-DEIGEN_MAX_ALIGN_BYTES0禁用对齐第三种方式最省事但会牺牲SIMD性能不建议在追求性能的项目里用。Eigen官方文档里对这个问题的描述非常详细核心原则就是允许编译器告诉你如何对齐不要自己去手动控制内存地址。4.3 下载渠道与验证包完整性Eigen 3.3.3安装包建议优先使用官方发布页的release附件或者是官方git镜像仓库的tag标签。下载完成后建议先做两步验证校验文件大小和解压是否报错很多“安装失败”其实是压缩包下载不完整导致解压缺文件解压后检查Eigen/src/Core/util/Macros.h里的三个宏是否匹配3.3.3另外下载的Eigen安装包建议归档保存因为很多项目构建时对Eigen的版本是硬性要求万一以后换电脑、换环境安装包还是原来那个版本最稳妥。我本地的做法是建了一个/libs/eigen/3.3.3目录专门存放源码包和解压后的文件用CMake时直接定位这个目录从不在系统全局目录里装来装去。常见问题原因解决方案编译报找不到Eigen/Coreinclude路径未配置或写错层级检查include路径指向包含Eigen目录的上级目录版本输出3.3.7但想要3.3.3多版本共存路径污染用grep定位实际生效的头文件路径清理多余版本static assertion failed对齐报错固定尺寸Eigen类型对齐问题添加EIGEN_MAKE_ALIGNED_OPERATOR_NEW或使用aligned_allocatorCMake提示找不到Eigen3find_package搜索路径不包含安装目录显式设置Eigen3_DIR缓存变量指向配置文件目录解压失败或缺文件下载源包损坏重新下载并校验文件完整性最后再分享一个个人经验Eigen这个库版本不在多新而在准。很多项目锁3.3.3不是因为新功能而是因为测试全部在这个版本上跑过贸然更新版本编译能过但结果可能就变了。安装Eigen这件事最忌讳的就是“这个版本应该也能用”的侥幸心理。该锁定3.3.3就锁死别让“版本漂移”成为你调不通代码的第一嫌疑人。本文还有配套的精品资源点击获取
简介Eigen 3.3.3 是一份面向 C 开发者的线性代数库源码压缩包广泛用于矩阵与向量运算、稀疏求解、几何变换等数值计算场景。这份资源基于 eigen-3.3.3 官方源码整理共包含 2000 个文件容量约 9.74MB主体为 .h/.hh 头文件与模板实现另配有大量 make、cmake 构建脚本、cpp/cu 示例程序、txt 说明文档以及 json 配置文件便于在 CMake 或 Make 工程中快速引用。作为纯头文件库Eigen 无需预编译和链接解压后把 Eigen 目录加入项目包含路径即可直接使用这对需要离线安装包的开发者非常方便。包内还保留了 dox 文档和单元测试样例可辅助理解矩阵乘法、特征值分解等核心接口。资源已获得 681 人学习下载适合希望在本地搭建 Eigen 开发环境或快速上手线性代数运算的工程师选用。 搞机器人、视觉SLAM或者点云处理的朋友估计没少跟Eigen打交道。它就是那个让你用一行代码完成矩阵逆运算、SVD分解、特征值计算的C模板库号称“下载解压就能用”。但问题恰恰出在这个“下载解压”上网上教程绝大多数都在讲最新版3.4.x可很多老项目比如ORB-SLAM2、VINS-Mono明确锁定了eigen 3.3.3版本安装包照着新版教程操作CMake配置和头文件路径经常对不上一不小心就编译报错。这篇博文就围绕eigen 3.3.3版本安装包来写把Windows、Linux、macOS三平台的下载安装、CMake集成、版本校验和常见坑一次说清楚。不管你是刚入门C的小白还是被老项目折腾到头疼的开发者照着操作都能装上并跑通。1. 先搞清楚Eigen 3.3.3 到底是一个什么样的包很多人在第一步就迷糊了因为Eigen的“安装”和普通库的“安装”完全不是一个概念。这直接决定了你后续所有操作的方式。1.1 纯头文件库下载解压就已经“装完一半”Eigen是一个header-only的模板库也就是说它的源码全部由.h头文件组成没有.so、没有.dll、没有.a也不需要单独编译成二进制文件。编译器在编译你的代码时会直接把Eigen的模板实现展开到你的程序里。用生活来类比普通库安装像是买一台整机插上电源就能用而Eigen更像拿到一箱零件最关键的“组装图纸”就在头文件里编译时自动拼装。所以“安装eigen 3.3.3”本质上只做两件事获取eigen 3.3.3源码包让编译工具编译器、CMake、IDE能找到它include目录下的头文件这就导致很多人第一次安装时产生一个困惑“我make install了为什么没有生成库文件”——根本没有库文件可生成你安装的是头文件和CMake配置文件。但细节上还是有讲究的。源码包解压后你会看到Eigen目录注意大小写Linux下严格区分和unsupported目录。Eigen是官方稳定模块unsupported是实验性模块比如FFT、多项式、样条。CMake配置时要特别注意include路径要指到包含Eigen目录的上一级而不是直接指到Eigen文件夹里面。我见过太多人把路径写成include/Eigen结果编译器死活找不到#include Eigen/Core。1.2 为什么老项目都把版本锁死在 3.3.3Eigen 3.3.3发布于2017年在3.3系列里算是承上启下的版本。它的API接口非常稳定后续3.3.4到3.3.7基本都是修bug和做编译兼容性优化功能上变化不大。很多经典开源项目在2017到2019年间活跃维护就把依赖锁在了这个版本上。3.3.3版相比早期版本有几个核心变化改进了向量化代码生成对SSE/AVX指令集支持更成熟优化了矩阵求逆和线性求解器性能提供了更完善的C11支持修复了此前版本中部分内存对齐导致的崩溃问题表格对比3.3系列常见版本版本发布时间核心特点适用场景3.3.12016年3.3系列首个稳定版老教程、老系统3.3.32017年接口稳定、兼容性好大量视觉SLAM项目锁定此版本3.3.42017年修复3.3.3若干编译期bug需要小修版本再升级3.3.72018年3.3系列最终版兼容性最佳无明显理由时的稳妥选择这里有个很实际的场景Ubuntu 18.04通过apt默认安装的libeigen3-dev就是3.3.4Ubuntu 20.04自带3.3.7也就是说用包管理器安装大概率装不到3.3.3。如果你跟我一样遇到“项目文档明确写了要求Eigen 3.3.3编译时却提示版本不匹配”那大概率就是包管理器版本和项目要求对不上。2. 动手安装三种主流安装方式与平台适配搞清楚了Eigen的header-only属性接下来就是实操。我按平台来拆每个平台给一个最稳妥的方案。2.1 Windows解压即用关键是路径别放错Windows下最省事的方式就是下载官方release的zip压缩包然后解压到一个固定目录。步骤很简单去官方发布页找到3.3.3版本的zip包解压到某个无中文、无空格的路径例如D:\libs\eigen-3.3.3在Visual Studio的项目属性里把D:\libs\eigen-3.3.3添加到“C/C → 常规 → 附加包含目录”代码里直接#include Eigen/Core就可以编译如果你用CMake那更简单在CMakeLists.txt里加上include_directories(D:/libs/eigen-3.3.3)或者用find_package(Eigen3 REQUIRED)后面详讲。Windows下的两个坑要重点说第一路径别带空格和中文。有人把Eigen解压到C:\Program Files (x86)\eigen 3.3.3结果CMake的find_package解析路径时被空格搞崩溃折腾半天还以为是Eigen和VS不兼容。第二zip包解压后有个顶层目录比如eigen-eigen-5a0156e40feb这种带哈希后缀的这个哈希目录名没有固定规律解压后要么重命名成eigen-3.3.3要么在配置时找准路径。我见过有个同事把哈希目录名原封不动写进CMakeLists结果换一台电脑解压哈希变了路径又失效浪费时间。2.2 Linux源码编译安装与包管理器安装二选一Linux下有两种安装方式思路完全不同。方式一源码编译安装精确版本推荐wget https://github.com/eigenteam/eigen-git-mirror/archive/refs/tags/3.3.3.tar.gz tar -xzf 3.3.3.tar.gz cd eigen-git-mirror-3.3.3 mkdir build cd build cmake .. sudo make install执行完后头文件会安装到/usr/local/include/eigen3CMake配置文件会安装到/usr/local/share/eigen3/cmake/。这个方式的优点是指定版本精确、不会污染系统目录缺点是稍微多敲几条命令。方式二apt安装不推荐用于锁定版本sudo apt install libeigen3-devapt安装速度快、依赖管理省心但是版本完全由系统仓库决定。Ubuntu 18.04装出来是3.3.4Ubuntu 20.04是3.3.7你想要3.3.3根本选不了。所以项目明确要求3.3.3时老老实实用源码安装。这里多提一句源码安装里面的细节Eigen官方在构建时其实可以跳过build目录直接执行make install但官方文档推荐用out-of-source构建也就是先建一个build目录在里面执行CMake。原因是CMake会在源码目录生成一堆缓存文件和临时产物Eigen是纯模板库还好如果是其他项目会污染源码树。养成这个习惯以后编译其他库也能少吃点亏。2.3 macOSHomebrew与源码方式二选一macOS上最省力的方式是Homebrewbrew install eigen安装完成后终端会提示头文件路径在/opt/homebrew/include/eigen3Apple Silicon或/usr/local/include/eigen3Intel版。这种方式装到的版本取决于Homebrew仓库当前维护的版本要精确装3.3.3可以查看历史版本然后直接用源码编译方式跟Linux一样就是下载tar.gz、解压、cmake、make install一套流程。我在macOS上踩过一个小坑Homebrew安装的Eigen可能不是最新也是较新的但某些老项目编译时不看版本号只认路径结果代码里写的是老API新版本虽然兼容但行为有细微差别。所以如果你在Mac上编译老项目最稳妥的还是下载3.3.3源码包手动安装。2.4 header-only带来的“伪安装”现象这里要单独澄清一个问题很多人执行完源码安装后发现/usr/local/lib目录下并没有新增任何库文件就以为安装失败了。实际上这是正常的我用一行命令说明Eigen安装的最终结果/usr/local/include/eigen3/Eigen/Core /usr/local/share/eigen3/cmake/Eigen3Config.cmakeEigen安装完毕后主要产物就是头文件目录和一个CMake配置文件。没有二进制库文件。所以当你用ldconfig或者ls /usr/local/lib检查时看不到东西不代表安装有问题。3. CMake工程集成让编译器找到头文件安装只是第一步真正让工程跑起来的是CMake配置。Eigen在CMake里的集成方式非常灵活但也很容易写错。3.1 find_package 正确用法与 EXACT 精确匹配最规范的写法是cmake_minimum_required(VERSION 3.10) project(eigen_demo) set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(Eigen3 3.3 REQUIRED NO_MODULE) add_executable(demo main.cpp) target_link_libraries(demo Eigen3::Eigen)注意几个点NO_MODULE是为了使用Eigen3Config.cmake这种现代CMake的package配置模式而不是老的FindEigen3.cmake模块模式。如果你不加NO_MODULECMake会优先搜索FindEigen3.cmake而老模块里获取的变量名是EIGEN3_INCLUDE_DIR写法完全不同。版本号写3.3表示要求3.3及以上版本如果你一定要精确3.3.3可以加EXACT参数find_package(Eigen3 3.3.3 EXACT REQUIRED NO_MODULE)这样CMake找到的版本只要不是3.3.3就会直接报错从底层杜绝“装错版本”的问题。如果不想用find_package也可以用最粗暴的include_directoriesinclude_directories(/usr/local/include/eigen3)这种写法的优点是简单直观缺点是换环境就得改路径也不方便版本管理。我建议新项目用Eigen3::Eigen目标方式老项目如果原本就是include_directories风格没必要瞎折腾保持原样就好。3.2 一个可直接编译的矩阵运算 Demo写一个最简单的Demo用来验证Eigen安装是否成功代码内容就是输出Eigen版本号并做一次矩阵乘法。#include iostream #include Eigen/Dense int main() { std::cout Eigen version: EIGEN_WORLD_VERSION . EIGEN_MAJOR_VERSION . EIGEN_MINOR_VERSION std::endl; Eigen::Matrix3d A; A 1, 2, 3, 4, 5, 6, 7, 8, 10; Eigen::Vector3d b(1, 2, 3); Eigen::Vector3d x A.colPivHouseholderQr().solve(b); std::cout Solution x:\n x std::endl; return 0; }编译并运行mkdir build cd build cmake .. make ./demo输出类似这样Eigen version: 3.3.3 Solution x: -0.333333 0.666667 0看到Eigen version: 3.3.3就说明安装和集成全部正常。3.3 编译期版本验证三件套除了上面Demo里的宏输出还有几种验证版本的方式按场景不同选择看宏EIGEN_WORLD_VERSION、EIGEN_MAJOR_VERSION、EIGEN_MINOR_VERSION三个宏组合出来的数字就是当前生效的版本。这是最直接的方式编译期就能看到。看CMake变量find_package成功后可以通过${Eigen3_VERSION}变量拿到版本号在CMakeLists里message(STATUS found Eigen version: ${Eigen3_VERSION})打印出来。看头文件路径编译器加-H参数或者-E -dM预处理输出能列出实际包含的头文件绝对路径排查多版本污染时非常好用。版本验证这一步千万别省。很多时候你以为装的是3.3.3实际因为环境变量PATH、CMake缓存、系统目录干扰编译用的根本不是同一个版本排查起来会异常痛苦。4. 常见问题与避坑实录最后这部分是我实际折腾Eigen时遇到的最多的坑整理成一个速查表另外每个问题展开说一下排查思路。4.1 多版本共存头文件路径污染怎么破场景是这样你自己源码编译了一个3.3.3到/usr/local/include/eigen3同时apt也装了一个3.3.7在/usr/include/eigen3。CMake的find_package搜索路径通常按“当前项目优先 → 用户目录 → 系统目录”的顺序但很多老项目的CMakeLists里又同时存在include_directories和find_package两个路径打架最终编译器可能用了/usr/include/eigen3里的3.3.7头文件。排查命令特别简单grep -R EIGEN_MINOR_VERSION /usr/include/eigen3/Eigen/src/Core/util/Macros.h grep -R EIGEN_MINOR_VERSION /usr/local/include/eigen3/Eigen/src/Core/util/Macros.h分别看看系统目录和用户目录里各自是什么版本。如果确实存在多版本解决方案有三个卸载apt安装的eigensudo apt remove libeigen3-dev用CMake的CMAKE_IGNORE_PATH排除特定搜索目录在CMakeLists里显式include_directories(BEFORE /usr/local/include/eigen3)让用户目录优先我个人的习惯是把所有个人编译的库都装在/usr/local系统包管理器装的一律不用然后通过CMake的NO_DEFAULT_PATH限制搜索范围一劳永逸。4.2 对齐断言与编译报错Eigen在3.3.x时代对内存对齐要求很高尤其是固定尺寸的向量和矩阵比如Vector4d、Matrix2d如果你在类里直接定义Eigen对象作为成员变量并且用STL容器存放固定尺寸Eigen类型很容易触发类似下面的编译断言static assertion failed: YOU_MIXED_VECTORS_OF_DIFFERENT_SIZES或者运行期崩溃报错和unaligned相关。解决办法有三个在类成员里添加EIGEN_MAKE_ALIGNED_OPERATOR_NEW宏使用Eigen::aligned_allocator替代std::allocator如果你确定不需要向量化加速可以在编译选项里加-DEIGEN_MAX_ALIGN_BYTES0禁用对齐第三种方式最省事但会牺牲SIMD性能不建议在追求性能的项目里用。Eigen官方文档里对这个问题的描述非常详细核心原则就是允许编译器告诉你如何对齐不要自己去手动控制内存地址。4.3 下载渠道与验证包完整性Eigen 3.3.3安装包建议优先使用官方发布页的release附件或者是官方git镜像仓库的tag标签。下载完成后建议先做两步验证校验文件大小和解压是否报错很多“安装失败”其实是压缩包下载不完整导致解压缺文件解压后检查Eigen/src/Core/util/Macros.h里的三个宏是否匹配3.3.3另外下载的Eigen安装包建议归档保存因为很多项目构建时对Eigen的版本是硬性要求万一以后换电脑、换环境安装包还是原来那个版本最稳妥。我本地的做法是建了一个/libs/eigen/3.3.3目录专门存放源码包和解压后的文件用CMake时直接定位这个目录从不在系统全局目录里装来装去。常见问题原因解决方案编译报找不到Eigen/Coreinclude路径未配置或写错层级检查include路径指向包含Eigen目录的上级目录版本输出3.3.7但想要3.3.3多版本共存路径污染用grep定位实际生效的头文件路径清理多余版本static assertion failed对齐报错固定尺寸Eigen类型对齐问题添加EIGEN_MAKE_ALIGNED_OPERATOR_NEW或使用aligned_allocatorCMake提示找不到Eigen3find_package搜索路径不包含安装目录显式设置Eigen3_DIR缓存变量指向配置文件目录解压失败或缺文件下载源包损坏重新下载并校验文件完整性最后再分享一个个人经验Eigen这个库版本不在多新而在准。很多项目锁3.3.3不是因为新功能而是因为测试全部在这个版本上跑过贸然更新版本编译能过但结果可能就变了。安装Eigen这件事最忌讳的就是“这个版本应该也能用”的侥幸心理。该锁定3.3.3就锁死别让“版本漂移”成为你调不通代码的第一嫌疑人。本文还有配套的精品资源点击获取
