引入Eigen时遭遇多重定义问题，附最小复现示例

嘿，这个问题我之前在项目里也踩过坑，其实核心是头文件重复包含+编译单元实例化冲突导致的，咱们一步步来解决：

问题根源分析 #

你单文件编译时没问题，是因为所有代码都在一个编译单元（main.cpp）里，Eigen的模板和相关代码只会被实例化一次；但当你加入common2.cpp后，现在有两个独立的编译单元（main.cpp和common2.cpp），它们都通过头文件链包含了<Eigen/Dense>，如果头文件没有保护，或者有全局变量/非模板函数定义在头文件里，链接时就会出现“多重定义”的错误——因为两个编译单元都生成了相同的符号实例。

具体解决方案 #

1. 给所有头文件加上头文件保护（必须做！） #

这是C++头文件的基础规范，能彻底避免同一个头文件被多次包含到不同编译单元里。修改你的头文件：

common1.hpp：

#ifndef COMMON1_HPP
#define COMMON1_HPP

#include <Eigen/Dense>

#endif // COMMON1_HPP

common2.hpp：

#ifndef COMMON2_HPP
#define COMMON2_HPP

#include "common1.hpp"

#endif // COMMON2_HPP

也可以用#pragma once替代（大部分主流编译器都支持），效果是完全一致的。

2. 检查头文件里的全局变量/非模板函数 #

如果你的common1.hpp或common2.hpp里定义了非模板的全局变量、函数（比如Eigen::Vector3d global_vec;或者void print_mat(Eigen::MatrixXd& mat) { ... }），这些内容会被每个包含头文件的编译单元复制一份，链接时必然冲突。

解决办法：

• 把变量/函数的定义移到.cpp文件里，头文件里只留声明：
  比如在common2.hpp里声明：

  extern Eigen::Vector3d global_vec; // 声明
  void print_mat(Eigen::MatrixXd& mat); // 声明
  

  然后在common2.cpp里定义：

  #include "common2.hpp"
  
  Eigen::Vector3d global_vec; // 定义
  void print_mat(Eigen::MatrixXd& mat) {
      // 函数实现代码
  }
  

3. 确保所有编译单元的Eigen宏定义一致 #

如果你在编译时给某个文件加了Eigen的特殊宏（比如EIGEN_DONT_INLINE、EIGEN_NO_DEBUG），要确保所有.cpp文件都用相同的宏编译，否则不同编译单元生成的符号会不一致，导致链接冲突。

比如编译时要统一加宏参数：

clang++ main.cpp common2.cpp -DEIGEN_NO_DEBUG -o program

4. 模板特化的注意事项 #

如果你自己写了基于Eigen的模板特化（比如template<> void my_func<Eigen::MatrixXd>(...)），要确保这个特化只在一个.cpp文件里定义，或者用inline修饰，避免多个编译单元都生成特化实例。

验证修改后的编译 #

修改完成后，用以下命令编译：

clang++ main.cpp common2.cpp -o my_program

应该就能正常通过编译了。

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