CMake无需单独CMakeLists.txt引入外部库的配置方法

完全可以不额外在libA目录下编写CMakeLists.txt完成依赖配置，你现有配置可运行但存在明确疏漏，以下是可直接使用的配置方案和问题说明。

方案1：导入预编译静态库（推荐，和手动编译逻辑完全匹配） #

你手动编译命令里是直接链接预编译好的libA.a，不需要重复编译libA的源码，用CMake的导入目标功能就能完成配置，不需要给libA加任何文件：

cmake_minimum_required(VERSION 3.16.3)
project(test)

# 声明导入的静态库目标
add_library(libA STATIC IMPORTED)
# 配置静态库路径、对应头文件目录，用CMAKE_SOURCE_DIR锚定项目根目录，避免相对路径解析错误
set_target_properties(libA PROPERTIES
  IMPORTED_LOCATION "${CMAKE_SOURCE_DIR}/include/libA/libA.a"
  INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_SOURCE_DIR}/include/libA/lib/include"
)

# 仅编译项目自身源码
add_executable(${PROJECT_NAME} src/main.cpp src/fileA.cpp)
# 链接libA，头文件路径会自动传递到可执行目标，无需额外配置include目录
target_link_libraries(${PROJECT_NAME} PRIVATE libA)

这个方案的优势：

• 路径解析稳定，不会因为执行cmake的工作目录变化、构建目录位置调整出现找不到文件的问题
• 头文件属性和库目标绑定，不会出现冗余配置，后续如果项目新增其他目标，需要依赖libA时直接链接即可，不用重复配置头文件
• 不修改libA目录下的任何内容，完全符合你不想编写额外CMakeLists的需求
• 不会重复编译libA源码，构建速度和你手动执行clang命令完全一致

方案2：直接编译libA源码到可执行文件 #

如果你不想用预编译的libA.a，要把libA的源码直接编译进最终的可执行文件，也不需要额外CMakeLists，配置更简单：

cmake_minimum_required(VERSION 3.16.3)
project(test)

# 把自身源码和libA需要编译的源码都加入构建列表
add_executable(${PROJECT_NAME} 
  src/main.cpp 
  src/fileA.cpp 
  include/libA/src/source.c
)
# 配置一次头文件搜索路径即可，可执行文件作为最终产物用PRIVATE属性
target_include_directories(${PROJECT_NAME} PRIVATE include/libA/lib/include)

注意：用这个方案就不要再链接libA.a了，否则会出现符号重复定义的编译错误

你原有配置的具体疏漏 #

• 静态库路径错误：target_link_libraries里写的/include/libA/libA.a是系统根目录下的绝对路径，和你项目里的实际路径不符，当前能运行属于环境偶合，换个环境或者调整构建目录就会报找不到库的错误
• 冗余配置：同时使用了include_directories全局头文件配置和target_include_directories目标级配置，全局配置会给项目下所有后续新增的构建目标都加上libA的头文件路径，容易引发头文件冲突
• 逻辑冲突：既把libA的源码source.c加入了编译列表，又要链接已经编译好的libA.a，二者包含完全相同的符号，正常构建流程下会触发重复定义错误，当前能运行是链接器做了容错处理，属于不稳定状态
• 属性使用错误：给可执行目标的头文件配置用了PUBLIC属性，PUBLIC适用于会被其他目标依赖的库目标，最终可执行文件不会被其他目标链接，用PRIVATE即可

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