交叉编译树莓派4时如何让CMake定位到自定义路径下的ZLIB库

我之前交叉编译树莓派项目时也碰到过一模一样的问题，CMake能识别出头文件版本却找不到库文件，用HINTS又触发配置文件缺失的错误——这本质是因为交叉编译环境下，CMake的默认查找路径没覆盖到arm架构专属的库目录，而且NO_DEFAULT_PATH参数会打乱FindZLIB模块的默认查找逻辑。给你几个亲测有效的解决办法：

方法1：手动指定ZLIB的头文件和库路径 #

直接绕过find_package的自动查找逻辑，先手动定位到头文件和库文件，再让CMake用这些已知路径完成后续配置：

cmake_minimum_required(VERSION 3.18)

# 先手动查找ZLIB的头文件和库
set(sysroot_dir "/home/user/bla/sysroot")
find_path(ZLIB_INCLUDE_DIR NAMES zlib.h PATHS "${sysroot_dir}/usr/include" NO_CMAKE_FIND_ROOT_PATH)
find_library(ZLIB_LIBRARY NAMES z PATHS "${sysroot_dir}/usr/lib/arm-linux-gnueabihf" NO_CMAKE_FIND_ROOT_PATH)

# 再调用find_package，它会复用我们已经找到的变量
find_package(ZLIB REQUIRED)

# 后续正常添加你的目标和链接逻辑
add_executable(your_target main.c)
target_link_libraries(your_target PRIVATE ZLIB::ZLIB)

方法2：扩展CMake的库查找路径 #

在你的工具链文件里，把arm架构专属的库目录加入CMAKE_LIBRARY_PATH，这样FindZLIB模块会自动优先搜索这个目录，不用手动指定路径：

修改你的toolchain.cmake，在设置CMAKE_FIND_ROOT_PATH之后添加：

# 加入arm架构专属的库路径
set(CMAKE_LIBRARY_PATH "${sysroot_dir}/usr/lib/arm-linux-gnueabihf" ${CMAKE_LIBRARY_PATH})

然后回到CMakeLists.txt，只需要保留基础的find_package即可：

cmake_minimum_required(VERSION 3.18)
find_package(ZLIB REQUIRED)

方法3：利用ZLIB_ROOT变量引导查找 #

FindZLIB模块支持通过ZLIB_ROOT变量指定ZLIB的根目录，结合架构库路径的设置，也能让CMake正确找到库：

cmake_minimum_required(VERSION 3.18)

set(sysroot_dir "/home/user/bla/sysroot")
set(ZLIB_ROOT "${sysroot_dir}/usr")
# 引导CMake到arm架构库目录查找
set(CMAKE_LIBRARY_PATH "${ZLIB_ROOT}/lib/arm-linux-gnueabihf" ${CMAKE_LIBRARY_PATH})

find_package(ZLIB REQUIRED)

为什么之前的HINTS+NO_DEFAULT_PATH会报错？ #

当你加上NO_DEFAULT_PATH参数时，CMake会跳过FindZLIB模块默认的“查找头文件+库文件”逻辑，转而寻找ZLIB的官方配置文件（ZLIBConfig.cmake或zlib-config.cmake），但交叉编译的sysroot里通常不会包含这类CMake配置文件，所以才会触发找不到配置文件的错误。除非你自己生成了ZLIB的配置文件，否则不要用NO_DEFAULT_PATH。

最后再检查一下你的sysroot路径是否正确：确保/home/user/bla/sysroot/usr/lib/arm-linux-gnueabihf/libz.so确实存在，且是有效的符号链接（比如链接到libz.so.1.2.11）。

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