CMake中IMPORTED与IMPORTED_LOCATION属性的用途及疑问

一、核心概念说明 #

• IMPORTED库：用add_library(shared1 SHARED IMPORTED)声明的是外部已存在的预编译库，不是当前工程里要编译生成的库。CMake把这类库当作一个"目标"来管理，方便整合到整个构建流程中。
• IMPORTED_LOCATION属性：通过set_target_properties设置这个属性，就是告诉CMake这个外部库具体在磁盘的哪个位置，相当于给CMake指明确切的库文件路径。

二、为啥明明库在默认路径还要这么写？ #

你提到库在/usr/local/lib（链接器默认搜索路径），直接用-lshared1链接器也能找到，但用CMake的导入库方式有不可替代的作用：

1. 符合CMake的目标依赖逻辑 #

CMake是基于"目标（target）"的构建系统，target_link_libraries本质是让两个目标建立依赖关系。如果直接写target_link_libraries(proj PRIVATE shared1)，CMake会默认认为shared1是工程内的目标，找不到的话可能报错，或者即使链接器能找到，CMake的其他流程（比如生成编译命令、依赖检查）会缺失关键信息。显式声明导入库，就是告诉CMake："这是一个外部库，我给你指了路径，你把它当作合法目标来处理"。

2. 配置更清晰、可维护 #

显式声明导入库后，任何人看CMakeLists.txt都能立刻知道shared1是外部依赖，不是本工程的源码编译出来的。后续如果库的路径变了（比如从/usr/local/lib移到/opt/libs），只需要改IMPORTED_LOCATION这一处，不用到处找链接命令修改。

3. 天然支持跨平台 #

不同系统的库文件格式和路径规则天差地别：Windows是.dll/.lib，macOS是.dylib，Linux是.so。用导入库可以通过条件判断统一配置：

if(WIN32)
    set_target_properties(shared1 PROPERTIES IMPORTED_LOCATION "C:/third-party/libs/shared1.dll")
elseif(APPLE)
    set_target_properties(shared1 PROPERTIES IMPORTED_LOCATION "/usr/local/lib/libshared1.dylib")
else()
    set_target_properties(shared1 PROPERTIES IMPORTED_LOCATION "/usr/local/lib/libshared1.so")
endif()

要是直接写库名，跨平台时得手动处理各种差异，麻烦得多。

4. 能传递更多依赖属性 #

导入库不止能指定路径，还可以附加头文件路径、编译选项等属性，这些会自动传递给链接它的目标。比如：

set_target_properties(shared1 PROPERTIES
    IMPORTED_LOCATION "/usr/local/lib/libshared1.so"
    INTERFACE_INCLUDE_DIRECTORIES "/usr/local/include/shared1"
)

这样你的可执行文件proj会自动包含/usr/local/include/shared1路径，不用再单独写target_include_directories，省心又不易出错。

5. 提前验证库的存在 #

显式设置IMPORTED_LOCATION后，CMake在配置阶段（不是链接阶段）就会检查这个路径下的库是否存在，如果找不到会直接报错，让你提前排查问题，而不是等到编译到链接环节才发现问题，节省排查时间。

三、和直接写库名的区别 #

如果图省事直接写target_link_libraries(proj PRIVATE shared1)，链接器确实会通过-lshared1在默认路径找库，但这种写法有明显短板：

• CMake没法提前验证库是否存在，只有链接时才报错，排查成本高；
• 头文件路径、编译选项等依赖得手动单独设置，容易遗漏；
• 跨平台时要手动处理不同系统的库名差异，配置混乱。

总的来说，用add_library(IMPORTED)和set_target_properties(IMPORTED_LOCATION)是CMake管理外部依赖的标准姿势，既能让配置更规范，又能利用CMake的目标系统解决各种依赖管理问题，远比直接写库名靠谱。

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