CMake：如何使用LINK_INTERFACE_MULTIPLICITY？链接MKL静态库遇未定义引用

我来帮你搞定MKL静态库链接时的麻烦，顺便把LINK_INTERFACE_MULTIPLICITY的用法讲清楚。

为什么会出现未定义引用？ #

你遇到的问题核心是MKL静态库之间存在循环依赖，比如mkl_core和mkl_sequential互相依赖对方的符号。链接器处理静态库是按顺序单次扫描的：当它先处理mkl_intel_lp64，再处理mkl_sequential时，后者引用的mkl_core符号还没被处理；等处理到mkl_core时，前面的库已经过了扫描阶段，导致后续的符号无法解析，就出现了类似ztre...这类未定义引用。

最省心的解决方案：用MKL官方CMake模块 #

手动导入库很容易踩依赖顺序的坑，Intel已经为我们准备好了CMake模块，能自动处理所有依赖和链接逻辑，直接用就行：

# 先指定MKL安装路径（如果系统没自动识别到的话）
set(MKL_ROOT /opt/intel/mkl)
find_package(MKL REQUIRED)

# 直接链接MKL的目标，不用管具体库名
target_link_libraries(main PRIVATE MKL::MKL)

这样CMake会自动处理循环依赖，帮你生成正确的链接命令，完全不用手动维护库列表。

手动导入库的解决方案（处理循环依赖） #

如果必须手动导入库，你需要让链接器重复扫描这些库，才能解析循环依赖的符号。有两种方式：

方式1：重复列出库列表 #

直接在target_link_libraries里把库列表写两次，让链接器扫描两轮：

set(LIBRARIES mkl_intel_lp64 mkl_sequential mkl_core)
foreach(_lib ${LIBRARIES})
    add_library(${_lib} UNKNOWN IMPORTED)
    set_target_properties(${_lib} PROPERTIES 
        IMPORTED_LOCATION /opt/intel/mkl/lib/intel64/lib${_lib}.a
    )
endforeach()

# 重复库列表，解决循环依赖
target_link_libraries(main PRIVATE ${LIBRARIES} ${LIBRARIES})

方式2：使用LINK_INTERFACE_MULTIPLICITY属性 #

这个CMake属性的作用是：指定链接依赖该目标时，链接器需要扫描该目标接口库的次数，刚好用来解决静态库循环依赖，不用手动重复写库列表。

修改你的导入代码，为每个MKL库设置该属性：

set(LIBRARIES mkl_intel_lp64 mkl_sequential mkl_core)
foreach(_lib ${LIBRARIES})
    add_library(${_lib} UNKNOWN IMPORTED)
    set_target_properties(${_lib} PROPERTIES 
        IMPORTED_LOCATION /opt/intel/mkl/lib/intel64/lib${_lib}.a
        LINK_INTERFACE_MULTIPLICITY 2  # 让链接器扫描该库2次
    )
endforeach()

# 正常链接即可，CMake会自动处理重复扫描
target_link_libraries(main PRIVATE ${LIBRARIES})

设置LINK_INTERFACE_MULTIPLICITY 2后，CMake在生成链接命令时，会把每个MKL库重复两次，效果和手动写两次库列表一样，但更简洁。

关于LINK_INTERFACE_MULTIPLICITY的补充说明 #

这个属性专门针对静态库循环依赖场景：当库A依赖库B的符号，库B又依赖库A的符号时，单次扫描链接器无法同时解析两个方向的引用，需要多次扫描。

• 它是目标属性，只能用于CMake目标（包括导入库）；
• 数值一般设为2（大部分循环依赖场景足够），如果还是有未定义引用，可以尝试设为3；
• 动态库不需要这个属性，因为动态库的符号是在运行时解析的，不存在链接时的循环依赖问题。

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