如何修改CMakeLists.txt以优先使用本地安装的软件包

一、强制使用本地编译的foo包 #

你的foo本地版本没有按标准结构安装（头文件在src/include，库和二进制在build目录下），需要明确告诉CMake搜索路径并屏蔽系统版本：

方法1：直接指定路径（适合无CMake配置文件的情况） #

在CMakeLists.txt中添加以下代码，完全绕过系统默认的foo包：

# 指定foo的头文件路径
include_directories(/home/me/.local/foo/src/include)
# 指定foo的库文件路径
link_directories(/home/me/.local/foo/build/lib)

# 链接foo库（根据实际库文件名调整，比如libfoo.so对应`foo`）
target_link_libraries(你的项目名称 PRIVATE foo)

方法2：用find_package强制搜索本地路径（如果foo有CMake配置文件） #

如果foo编译后生成了fooConfig.cmake或foo-config.cmake文件（一般在build/lib/cmake/foo目录下），可以用参数强制仅搜索本地路径：

find_package(foo REQUIRED 
    PATHS /home/me/.local/foo/build
    NO_DEFAULT_PATH  # 完全忽略系统默认搜索路径
)
target_link_libraries(你的项目名称 PRIVATE foo::foo)

二、让CMake识别本地编译的MySQL #

MySQL通常会提供标准CMake配置文件，推荐以下两种方式：

方法1：设置CMAKE_PREFIX_PATH（全局生效） #

可以在执行cmake命令时传入参数，或在CMakeLists.txt开头设置：

# 把本地MySQL路径加入前缀搜索列表，优先于系统路径
set(CMAKE_PREFIX_PATH "/home/me/.local/mysql" ${CMAKE_PREFIX_PATH})

# 正常查找MySQL包
find_package(MySQL REQUIRED)
target_link_libraries(你的项目名称 PRIVATE MySQL::MySQL)

CMAKE_PREFIX_PATH会让CMake优先搜索指定路径下的include、lib、lib/cmake等子目录，自动识别头文件和库。

方法2：手动指定头文件和库路径 #

如果find_package无法识别，可直接硬编码路径：

include_directories(/home/me/.local/mysql/include)
link_directories(/home/me/.local/mysql/lib)

# 定位MySQL库文件
find_library(MYSQL_LIB NAMES mysqlclient PATHS /home/me/.local/mysql/lib NO_DEFAULT_PATH)
target_link_libraries(你的项目名称 PRIVATE ${MYSQL_LIB})

关键CMake变量说明 #

给你理清楚你提到的几个变量的核心作用，避免混淆：

• CMAKE_PREFIX_PATH：最常用的全局搜索前缀，find_package、find_library、find_path都会优先扫描这里的路径，适合指定非系统依赖的位置。
• CMAKE_INCLUDE_PATH：仅给find_path搜索头文件提供额外路径，通用性不如CMAKE_PREFIX_PATH。
• CMAKE_LIBRARY_PATH：仅给find_library搜索库文件提供额外路径，同样不如CMAKE_PREFIX_PATH通用。
• CMAKE_FIND_ROOT_PATH：多用于交叉编译，指定目标系统的根目录，本地编译基本用不上。
• CMAKE_INSTALL_PREFIX：是你的项目编译完成后的安装路径，和查找依赖无关。
• CMAKE_SYSTEM_PREFIX_PATH：系统默认的前缀路径（如/usr、/usr/local），若要屏蔽系统依赖，可配合NO_SYSTEM_ENVIRONMENT_PATH参数，或调整CMAKE_PREFIX_PATH的优先级。

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