CMake首次配置子目录静态库依赖查找路径错误如何解决

你遇到的两次配置行为不一致问题，本质是混淆了CMake的配置阶段和生成/构建阶段的行为边界：

1. 执行add_subdirectory(a)时，CMake只会在配置阶段注册a目录下定义的库target，不会执行任何编译操作，自然不会在构建目录下生成.a静态库实体文件
2. find_library的工作逻辑是扫描磁盘上实际存在的文件，第一次配置时构建目录下还没有对应库文件，自然会跳过HINTS指定的构建路径，fallback到/usr/local/lib、/usr/lib这类系统路径搜索
3. 第一次配置完成后执行构建，才会真正编译生成a目录下的静态库，第二次跑CMake配置时磁盘上已经有对应库文件了，find_library才能命中构建目录下的文件，这就是你观察到的现象。

另外你贴的代码里有个语法笔误：get_target_property(BINARY_DIR ${FINDING_NAME} BINARY_DIR} 末尾多了一个右花括号，会直接触发CMake语法报错。

方案1：直接链接target（99%场景下的最优选择，强烈推荐） #

你写的整套find_library逻辑对于同项目内通过add_subdirectory引入的子模块完全是多余的。CMake的target模型天生支持跨子目录依赖，只要a目录下的静态库是通过标准add_library(lib_name STATIC source_files...)定义的，add_subdirectory(a)执行完成后，这些target在整个CMake工程范围内全局可见，b目录下的模块需要依赖a的库时，直接把target名传给target_link_libraries即可：

# 示例：b目录下某个库依赖a目录下的lib_a静态库
add_library(lib_b STATIC b_source1.cpp b_source2.cpp)
# 根据依赖传递需求选择PUBLIC/PRIVATE/INTERFACE
target_link_libraries(lib_b PUBLIC lib_a)

这种写法完全规避了路径查找问题：

• 不需要关心库文件实际输出到构建目录的哪个子路径，CMake自动处理
• 不依赖磁盘上是否已经生成库文件，配置阶段就能正确建立依赖关系，不存在第一次配置找不到的问题
• 自动传递依赖的头文件路径、编译选项、宏定义等target属性，不需要手动配置include目录
• 自动适配Debug/Release等多构建配置的路径差异，并行编译时自动保证依赖库先构建

方案2：特殊场景下直接读取target属性（仅适用于无法直接链接target的情况） #

如果因为特殊业务逻辑必须拿到库文件的实际磁盘路径，不要用find_library扫描，直接通过CMake内置的target属性或生成器表达式获取即可：

if(TARGET ${FINDING_NAME})
    # 用生成器表达式直接获取target对应配置下的实际输出文件路径
    set(FINDING_LIBRARY_PATH $<TARGET_FILE:${FINDING_NAME}>)
    list(APPEND ${DEPENDENCIES_LIST} ${FINDING_LIBRARY_PATH})
else()
    # 仅外部预编译库、系统库才需要用find_library查找
    find_library(FINDING_LIBRARY_PATH NAMES ${LIBRARY_NAME} REQUIRED)
    list(APPEND ${DEPENDENCIES_LIST} ${FINDING_LIBRARY_PATH})
endif()

注意：$<TARGET_FILE:xxx>是生成器表达式，仅能在target_link_libraries、add_custom_command这类支持生成器表达式的命令中使用，无法在配置阶段通过message命令打印出实际路径（配置阶段打印只会显示原始的生成器表达式字符串），会在生成构建脚本阶段自动替换为对应配置下的真实文件路径。

• 同CMake工程内通过add_subdirectory、FetchContent引入的内部依赖，永远优先直接链接target名，不要用find_library扫描构建目录，这是典型的反模式
• find_library的设计用途是查找工程外部的预编译库、系统安装库，不适合查找本工程构建生成的target
• 默认情况下add_library定义的target在引入后全局可见，不需要额外设置属性，如果遇到target不可见的问题，检查是否错误设置了EXCLUDE_FROM_ALL或者目录级别的特殊作用域规则。

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