如何让CMake find_library根据构建目标找到正确的库

这个问题我之前帮别人排查过好几次，核心有两个问题：一是你的变量检查逻辑写错了，导致第二个find_library总是覆盖第一个的结果；二是没有利用CMake的架构感知能力来精准匹配库文件。咱们一步步来解决：

1. 先修复变量判断的致命错误 #

你代码里的这个判断逻辑是错的：

if (NOT DEFINED ${SOME_LIB})

NOT DEFINED需要判断的是变量名，而${SOME_LIB}会展开成变量的值（比如找到的库路径或者空字符串）。这会导致不管第一个find_library有没有找到someLib_64，第二个find_library都会执行，直接把SOME_LIB覆盖成someLib.lib——这就是你指定了64位库名却还是拿到32位版本的关键原因。

正确的写法应该是二选一：

if(NOT SOME_LIB)
# 或者
if(NOT DEFINED SOME_LIB)

2. 添加架构感知的精准匹配逻辑 #

CMake提供了CMAKE_SIZEOF_VOID_P变量，32位构建时它的值是4，64位构建时是8。我们可以用这个变量动态设置要查找的库名优先级，确保64位构建优先找64位库。

修改后的完整CMake代码 #

cmake_minimum_required (VERSION 3.8)

# 根据构建架构动态设置目标库名
if(CMAKE_SIZEOF_VOID_P EQUAL 8)
    # 64位构建：优先查找64位库，找不到再降级（可选）
    set(SOME_LIB_NAMES someLib_64 someLib)
else()
    # 32位构建：优先查找32位库
    set(SOME_LIB_NAMES someLib someLib_64)
endif()

# 查找头文件目录
find_path(LIB_INCLUDE_DIR REQUIRED someLib.h 
    HINTS c:/Progra~1/someLib/include /usr/include
)

# 查找目标库
find_library(SOME_LIB REQUIRED
    NAMES ${SOME_LIB_NAMES}
    HINTS c:/Progra~1/someLib/Lib /usr/lib
)

# 添加可执行文件
add_executable(myProject "myProject.cpp" "myProject.h")

# 链接库（用PRIVATE更规范，因为库是当前可执行文件私有的）
target_link_libraries(myProject PRIVATE ${SOME_LIB})

# 设置头文件目录
target_include_directories(myProject PUBLIC ${LIB_INCLUDE_DIR})

3. 额外优化建议 #

• 我在find_path和find_library里加了REQUIRED关键字，这样如果找不到头文件或库，CMake会直接终止并报错，避免后续链接失败的模糊错误。
• 如果想更严格（只允许匹配对应架构的库，不降级），可以直接指定固定库名：

  if(CMAKE_SIZEOF_VOID_P EQUAL 8)
      set(SOME_LIB_NAME someLib_64)
  else()
      set(SOME_LIB_NAME someLib)
  endif()
  
  find_library(SOME_LIB REQUIRED
      NAMES ${SOME_LIB_NAME}
      HINTS c:/Progra~1/someLib/Lib /usr/lib
  )
  

  这种方式能彻底杜绝误链接错误架构库的情况。

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