如何查找CMake中带::命名空间的库的target_link_libraries名称

核心问题 #

在C++项目中使用CMake时，find_package的参数、target_link_libraries的目标名称（包括带::的命名空间目标），常与系统软件包名称不一致，如何高效找到这些名称？

实用方法 #

1. 查阅库的官方文档 #

绝大多数正规库会在文档中明确给出CMake集成步骤，包括find_package的参数和需要链接的目标名称。比如：

• nlohmann_json文档直接说明使用find_package(nlohmann_json REQUIRED)，链接目标为nlohmann_json::nlohmann_json
• SQLite3的CMake集成文档会标注提供SQLite::SQLite3导入目标

2. 查看CMake自带的Find模块说明 #

对于CMake官方提供的Find模块（如SQLite3、EXPAT），可以用以下命令查看模块详情，里面会列出定义的变量和导入目标：

cmake --help-module FindSQLite3

执行后会输出模块的功能说明，以及它生成的目标、变量信息，比如FindSQLite3就会明确提到SQLite::SQLite3这个目标。

3. 检查库安装目录下的Config文件 #

很多库安装后会生成<PackageName>Config.cmake或<PackageName>-config.cmake文件（通常在/usr/lib/cmake/<PackageName>/或类似路径），打开这些文件就能看到导入目标的定义。比如：

• PahoMqttCpp的Config文件里会声明PahoMqttCpp::paho-mqttpp3目标
• nlohmann_json的Config文件里定义了nlohmann_json::nlohmann_json

4. 用CMake调试命令查看已导入目标 #

在CMakeLists.txt中添加调试语句，运行CMake时会打印所有已导入的目标名称：

message("已导入的CMake目标: ${CMAKE_IMPORTED_TARGETS}")

执行cmake ..后，就能在输出中找到你需要的目标名称。

5. 系统软件包与CMake包名的对应 #

Ubuntu等发行版的软件包名（如liblog4cxx-dev）和CMake的包名（log4cxx）通常不同，可通过以下方式确认：

• 查看软件包的文件列表：

  dpkg -L liblog4cxx-dev
  

  若列表中包含log4cxxConfig.cmake或Findlog4cxx.cmake，文件名的前缀就是find_package需要的参数。

名称不一致的原因 #

• CMake包名由库开发者定义，而系统软件包名要符合发行版的命名规范（比如加lib前缀、-dev后缀），因此两者常不一致。
• 带::的命名空间目标是现代CMake的推荐写法，用于避免目标名冲突，命名空间通常与库的品牌名或包名相关，但可能会做简化调整（比如SQLite3的包名是SQLite3，目标是SQLite::SQLite3）。

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