CMake交叉编译时无法正确指定Qt5包路径的问题求助

1. 修正find_package的路径参数用法 #

你使用PATH参数的方式不符合CMake语法，正确的参数是PATHS（复数形式），调整后的命令：

find_package(Qt5 5.15 REQUIRED COMPONENTS Widgets PATHS /home/raspberrypi4/qt5.15/)

同时确认目标Qt的CMake配置文件存在于/home/raspberrypi4/qt5.15/lib/cmake/Qt5目录下，这是CMake识别Qt包的核心路径。

2. 提升CMAKE_PREFIX_PATH的搜索优先级 #

CMake默认会优先搜索系统路径，可能导致你设置的CMAKE_PREFIX_PATH被覆盖。可以在CMakeLists.txt开头显式将目标Qt路径放在搜索列表最前端：

set(CMAKE_PREFIX_PATH "/home/raspberrypi4/qt5.15" ${CMAKE_PREFIX_PATH})

也可以在执行CMake配置时通过命令行传递：

cmake .. -DCMAKE_PREFIX_PATH=/home/raspberrypi4/qt5.15

3. 检查交叉编译工具链文件配置 #

交叉编译场景下，工具链文件的配置直接影响CMake的路径搜索逻辑，需确保：

• 正确设置CMAKE_SYSTEM_NAME为Linux
• 指定CMAKE_SYSROOT为/home/raspberrypi4/sysroot
• 工具链文件中未错误添加系统默认Qt的路径到搜索列表
  如果工具链配置遗漏或错误，CMake会自动转向sysroot内的默认Qt包。

4. 强制限制包搜索范围 #

通过设置CMAKE_FIND_ROOT_PATH_MODE_PACKAGE变量，让CMake仅在指定的前缀路径和sysroot内搜索包，不访问主机系统的路径：

set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

这能彻底避免CMake找到主机本地Qt或sysroot内的无关Qt配置。

5. 直接指定Qt配置文件路径 #

如果以上方法无效，可以跳过CMake的自动搜索逻辑，直接引入Qt的配置文件：

include("/home/raspberrypi4/qt5.15/lib/cmake/Qt5/Qt5Config.cmake")
find_package(Qt5Widgets REQUIRED)

或者用CONFIG参数精准指定路径：

find_package(Qt5 REQUIRED COMPONENTS Widgets CONFIG PATHS "/home/raspberrypi4/qt5.15/lib/cmake/Qt5")

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