CMake构建时ld报cannot find library错误但库路径已正确配置如何解决

问题原因 #

从你提供的make V=1输出可以看到，链接参数里已经正确添加了-L/path/to/proj/lib，排查方向可以缩小到以下两点：

1. 库命名不符合链接器规则（最高概率）：Linux链接器处理-lxxx参数时，会自动拼接前缀lib和后缀.so/.a来查找库文件，也就是你写-lcoolfoo时，ld实际查找的文件是libcoolfoo.so。而你当前的库文件名为coolfoo.so，缺少了lib前缀，自然无法被匹配到。
2. 其他低概率原因：库文件权限不足、库架构和目标程序架构不匹配、路径拼写错误等。

解决方案 #

推荐方案（符合Linux库规范） #

将${PROJECT_SOURCE_DIRECTORY}/lib目录下的coolfoo.so重命名为libcoolfoo.so，重新执行make即可解决问题。

无需修改库名的替代方案 #

如果你不想调整库文件名，可以选择以下任意一种方法修改CMakeLists.txt：

• 直接传入库的完整路径：

  target_link_libraries(TargetApp 
    "m"
    ${PROJECT_SOURCE_DIRECTORY}/lib/coolfoo.so
  )
  

  这种写法会让CMake直接把完整路径传给链接器，跳过-l参数的自动查找逻辑。
• 给链接器指定精确库名：

  target_link_libraries(TargetApp 
    "m"
    ":coolfoo.so"
  )
  

  链接参数里加冒号前缀后，ld会直接查找coolfoo.so文件，不会自动添加lib前缀。

额外排查点 #

如果上述方案无效，可以按以下步骤排查：

• 执行ls -l /path/to/proj/lib确认库文件存在，且当前用户有读权限
• 执行file /path/to/proj/lib/coolfoo.so确认库的架构和你编译的目标程序架构一致（比如都是x86_64）
• 确认你使用的PROJECT_SOURCE_DIRECTORY变量是正确定义的：CMake内置的项目源码根目录变量为PROJECT_SOURCE_DIR，如果你没有自定义PROJECT_SOURCE_DIRECTORY，请修正变量名。

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