CMake构建外部静态库并引入时的链接错误问题咨询

遇到这种CMake静态库链接的问题，我之前也踩过不少坑，给你整理几个排查和解决的方向，一步步来应该能搞定：

一、先确认外部库的静态库是否真的构建出来了 #

• 首先去构建目录里找CMakeCache.txt，搜索build_static_lib这个选项，确认它的值是ON。有时候你以为在顶层设置了，但子目录的CMakeLists可能有默认值或者逻辑覆盖，导致这个选项没生效。
• 直接进入外部库的构建子目录，手动跑一遍make，看看有没有生成静态库文件（一般是libexternalproject.a这类）。如果连库文件都没生成，那问题根源在外部库的构建配置，得先把这个搞定。

二、检查顶层CMake的依赖配置是否规范 #

• 如果你用add_subdirectory引入外部库，一定要在添加子目录之前设置好它的选项，而且最好加上FORCE强制覆盖默认值：

  set(build_static_lib ON CACHE BOOL "Build external library as static" FORCE)
  add_subdirectory(external_lib)
  

• 链接的时候，千万别手动写-lexternalproject，一定要用外部库定义的目标名称来链接。比如外部库的CMake里如果写了add_library(externalproject STATIC ...)，那顶层链接应该这么写：

  target_link_libraries(your_project PRIVATE externalproject)
  

  用目标名的话，CMake会自动帮你处理库的路径、链接参数这些，根本不会出现找不到库的问题。

三、彻底清理缓存解决配置混乱问题 #

• 你说修改顶层CMake或者删Cache后问题变来变去，这明显是旧缓存在搞鬼。别只删根目录的CMakeCache.txt，直接把整个构建目录删掉重来最稳妥：

  rm -rf build/
  mkdir build && cd build
  cmake ..
  make
  

  子目录里的缓存文件有时候也会残留旧配置，全删了才能保证新配置完全生效。如果是用IDE构建的，记得让IDE也清理掉所有旧的构建产物，别留尾巴。

四、检查外部库的CMakeLists有没有特殊逻辑 #

• 有些库的build_static_lib选项会改目标名称，比如开启静态库后目标名变成externalproject_static。你去翻一下外部库的CMakeLists.txt，找到add_library的部分，确认静态库对应的目标名到底是什么，然后在顶层链接时用正确的名字。
• 另外，如果你的主项目是动态库，链接静态库时需要静态库开启PIC（位置无关代码）。要是外部库没开，你可以在顶层CMake里强制全局开启：

  set(CMAKE_POSITION_INDEPENDENT_CODE ON CACHE BOOL "Enable PIC for all targets" FORCE)
  

五、验证链接命令和库文件的实际情况 #

• 出现-lexternalproject找不到的错误时，你可以去构建目录里找CMakeFiles/your_project.dir/link.txt，看看完整的链接命令，确认-lexternalproject的位置，以及对应的库文件是不是在链接路径里。
• 如果库文件确实存在但不在默认路径里，你可以手动添加路径，但还是那句话，优先用目标链接的方式，实在不行再加：

  target_link_directories(your_project PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/external_lib)
  

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