如何为指定find_library()调用预声明搜索路径（CMake）

下面提供几种无需修改子项目源码的针对性解决方案，避免全局路径设置的副作用：

1. 为目标库设置专属搜索前缀 #

find_library会优先读取[目标库名]_DIR变量作为搜索前缀，这是比CMAKE_PREFIX_PATH更精准的方式：

首先通过FetchContent拉取并构建mbedtls：

include(FetchContent)
FetchContent_Declare(
  mbedtls
  GIT_REPOSITORY https://github.com/Mbed-TLS/mbedtls.git
  GIT_TAG v3.5.2 # 替换为你实际需要的版本
)
FetchContent_MakeAvailable(mbedtls)

在添加子项目前，为三个mbedtls相关库设置专属搜索目录：

# 指向mbedtls构建生成的静态库所在目录
set(MBEDTLS_LIBRARY_DIR "${mbedtls_BINARY_DIR}/library")

# 为每个find_library调用指定专属搜索前缀
set(MBEDTLS_DIR "${MBEDTLS_LIBRARY_DIR}")
set(MBEDX509_DIR "${MBEDTLS_LIBRARY_DIR}")
set(MBEDCRYPTO_DIR "${MBEDTLS_LIBRARY_DIR}")

# 引入子项目
add_subdirectory(path/to/your/subproject)

这种方式只会影响目标find_library的搜索逻辑，不会干扰项目中其他库的查找。

2. 直接预定义find_library的结果变量 #

如果你明确知道静态库的生成路径，可以直接给子项目中用到的变量赋值，完全跳过find_library的搜索流程：

include(FetchContent)
FetchContent_Declare(
  mbedtls
  GIT_REPOSITORY https://github.com/Mbed-TLS/mbedtls.git
  GIT_TAG v3.5.2
)
FetchContent_MakeAvailable(mbedtls)

# 直接指定静态库文件路径（Windows下替换为.lib后缀）
set(MBEDTLS_LIBRARY "${mbedtls_BINARY_DIR}/library/libmbedtls.a")
set(MBEDX509_LIBRARY "${mbedtls_BINARY_DIR}/library/libmbedx509.a")
set(MBEDCRYPTO_LIBRARY "${mbedtls_BINARY_DIR}/library/libmbedcrypto.a")

add_subdirectory(path/to/your/subproject)

这是最直接的方案，确保子项目完全使用你通过FetchContent构建的静态库。

3. 局部限制搜索路径范围 #

通过临时修改CMake的搜索模式，限制子项目中find_library的搜索范围，之后恢复全局设置：

include(FetchContent)
FetchContent_Declare(
  mbedtls
  GIT_REPOSITORY https://github.com/Mbed-TLS/mbedtls.git
  GIT_TAG v3.5.2
)
FetchContent_MakeAvailable(mbedtls)

# 保存原有全局搜索配置
set(ORIGINAL_FIND_MODE ${CMAKE_FIND_ROOT_PATH_MODE_LIBRARY})
set(ORIGINAL_FIND_PATH ${CMAKE_FIND_ROOT_PATH})

# 局部设置：仅在指定目录搜索库文件
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH "${mbedtls_BINARY_DIR}/library")

# 引入子项目
add_subdirectory(path/to/your/subproject)

# 恢复全局配置，避免影响后续代码
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ${ORIGINAL_FIND_MODE})
set(CMAKE_FIND_ROOT_PATH ${ORIGINAL_FIND_PATH})

这种方式适合需要严格隔离子项目搜索环境的场景，确保不会意外找到系统中已安装的mbedtls库。

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