CMake编译报错：找不到目标文件/usr/lib/x86_64-linux-gnu/libdl.a

问题根源 #

你的问题大概率来自以下几种情况：

• 提交了本地生成的CMake缓存文件、构建产物（比如CMakeCache.txt、Makefile），这些文件硬编码了本地机器的libdl路径
• CMakeLists.txt中直接使用libdl的绝对路径，未让CMake自动适配目标机器的库路径
• 提交的installations/目录包含本地编译的依赖，其中嵌入了本地系统的路径引用

具体解决步骤 #

1. 清理Git仓库中的本地构建残留 #

• 检查项目的.gitignore文件，确保添加以下规则（无则补充）：

  CMakeCache.txt
  CMakeFiles/
  Makefile
  build/
  installations/  # 若该目录是本地编译生成的依赖而非源码依赖
  

• 从Git仓库移除已提交的本地构建文件：

  git rm -r --cached CMakeCache.txt CMakeFiles/ installations/
  git commit -m "Remove local build artifacts with hardcoded paths"
  

• 在目标机器上删除旧构建目录，重新克隆或拉取最新代码后再启动构建。

2. 修正CMakeLists中libdl的引用方式 #

摒弃绝对路径，改用CMake自动查找机制：

• 在CMakeLists.txt中添加库查找逻辑：

  # 自动搜索目标机器上的dl库
  find_library(DL_LIBRARY NAMES dl)
  if(NOT DL_LIBRARY)
      message(FATAL_ERROR "dl library not found on the system!")
  endif()
  

• 链接目标时使用查找得到的库变量：

  target_link_libraries(your_target_name PRIVATE ${DL_LIBRARY})
  

  将your_target_name替换为项目实际的可执行文件/库名称。

3. 正确设置CMake库路径（先清缓存） #

之前设置路径无效大概率是旧缓存残留，先删除构建目录：

rm -rf build/

再重新执行cmake命令并指定库路径：

cmake -S . -B build -DCMAKE_LIBRARY_PATH=/usr/lib64 -DCMAKE_SYSTEM_LIBRARY_PATH=/usr/lib64

4. 处理installations/目录的依赖 #

• 若installations/是本地编译的二进制依赖，不要提交到Git，而是在目标机器上重新编译这些依赖，或者提供跨平台的依赖构建脚本。
• 若为源码依赖，确保这些依赖的CMakeLists也未硬编码路径，同样使用CMake的自动查找或变量引用逻辑。

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