使用Eigen向量时出现LNK2019未解析外部符号错误求助

问题根因 #

该LNK2019错误并非缺失Eigen依赖库，而是DX11Book静态库与BasicWindow项目编译时，Eigen相关配置不一致，导致两者识别的Eigen::Vector4f模板实例签名不匹配，链接器无法找到对应函数实现。

排查与解决方法 #

• 统一两边项目的Eigen全局宏配置
  重点检查EIGEN_DEFAULT_TO_ROW_MAJOR、EIGEN_MAX_STATIC_ALIGN_BYTES、EIGEN_DISABLE_ALIGNMENT这类影响Eigen模板参数默认值的宏，DX11Book静态库编译时定义的所有Eigen相关宏，必须在BasicWindow项目的预处理器定义中完全同步。你错误信息中Matrix模板参数的第4位0值就是对齐选项，两边对齐配置不一致就会导致这个参数值不同，最终函数签名不匹配。
  同时确保两边引用的Eigen头文件版本完全一致，不同版本的Eigen模板参数默认值可能存在差异，也会触发该问题。
• 统一编译配置
  两边项目的架构（x86/x64）、运行库版本、结构体对齐选项（项目属性->C/C++->代码生成->结构成员对齐）必须完全一致，不要出现一边编译x64静态库、另一边编译x86可执行文件的情况。
• 临时规避方案
  如果配置排查后仍无法解决，可直接将SetValue函数的实现移动到VectorParameterWriterDX11.h头文件中，添加inline修饰，代码示例如下：

  inline void VectorParameterWriterDX11::SetValue(const Eigen::Vector4f& value)
  {
      m_Value = value;
  }
  

  Eigen是纯头文件库，函数实现放头文件会直接编译到调用方模块，不会出现跨静态库的符号匹配问题。

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