如何让CMake指定自定义依赖目录？解决「所需包未找到」错误

当bar库安装在$HOME/include（头文件）和$HOME/lib（库文件）时，CMake默认仅搜索/usr、/usr/local等系统路径，会抛出「A required package was not found」错误。以下是实现类似Automake ./configure --with-bar=$HOME效果的几种方法：

方法一：命令行指定前缀路径（最贴合Automake用法） #

执行CMake配置时，通过-DCMAKE_PREFIX_PATH参数传入bar的安装前缀，CMake会自动在该前缀下的include和lib目录查找头文件与库：

cd foo
cmake -DCMAKE_PREFIX_PATH=$HOME ..

方法二：单独指定头文件和库路径 #

若需更精细控制，可分别指定头文件与库的搜索路径：

cd foo
cmake -DCMAKE_INCLUDE_PATH=$HOME/include -DCMAKE_LIBRARY_PATH=$HOME/lib ..

方法三：在CMakeLists.txt中显式配置（适合长期项目） #

若不想每次执行CMake都手动传参，可在项目的CMakeLists.txt中添加以下配置：

1. 查找bar的头文件和库：

# 定位bar.h的路径
find_path(BAR_INCLUDE_DIR bar.h
    PATHS $ENV{HOME}/include
    NO_DEFAULT_PATH
    DOC "Path to bar header"
)

# 定位libbar.a的路径
find_library(BAR_LIBRARY bar
    PATHS $ENV{HOME}/lib
    NO_DEFAULT_PATH
    DOC "Path to bar library"
)

2. 校验查找结果，未找到则终止配置：

if(NOT BAR_INCLUDE_DIR OR NOT BAR_LIBRARY)
    message(FATAL_ERROR "Bar library not found. Install bar or set correct paths.")
endif()

3. 将路径关联到项目：

include_directories(${BAR_INCLUDE_DIR})
target_link_libraries(foo ${BAR_LIBRARY})

提示：如果bar库提供了官方的barConfig.cmake文件，直接使用find_package(bar REQUIRED)并配合CMAKE_PREFIX_PATH即可自动完成查找。

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