交叉编译时CMake FindPython3无法找到Development.Module组件的问题求助

问题根源 #

CMake的FindPython3模块在交叉编译场景下的逻辑比较特殊：它会尝试运行Python可执行文件来获取版本、路径等关键信息，但目标系统的ARM架构Python程序无法在x86主机上运行，导致模块直接跳过了目标系统的查找路径；同时，模块默认的程序查找逻辑可能没有严格遵循CMAKE_FIND_ROOT_PATH的设置，即使你调整了CMAKE_FIND_ROOT_PATH_MODE_PROGRAM也可能不生效。

无需手动指定路径的解决方案 #

在你的工具链文件中添加以下配置，引导FindPython3模块正确识别目标系统的Python环境：

1. 强制模块优先查找目标系统的Python根目录 #

# 指向目标系统中Python的安装根目录（通常是/usr）
set(Python3_ROOT_DIR "${CMAKE_SYSROOT}/usr" CACHE PATH "Python3 root directory in target sysroot")
# 禁用Windows注册表查找（针对非Windows主机，避免干扰）
set(Python3_FIND_REGISTRY NEVER CACHE BOOL "Disable registry lookup for Python3")
# 禁用虚拟环境查找，确保使用目标系统的系统Python
set(Python3_FIND_VIRTUALENV NEVER CACHE BOOL "Never use virtualenv Python")

2. 让模块使用目标系统的python-config工具而非运行Python程序 #

# 指定目标系统的python3-config路径
set(Python3_CONFIG "${CMAKE_SYSROOT}/usr/bin/${target_triplet}-python3-config" CACHE FILEPATH "Python3 config tool in target sysroot")
# 强制模块使用config工具获取信息，而非尝试运行Python可执行文件
set(Python3_FIND_IMPLEMENTATIONS CPython CACHE STRING "Only look for CPython implementation")
set(Python3_FIND_NO_EXECUTABLE TRUE CACHE BOOL "Do not attempt to run Python executable")

3. 强化pkg-config的查找范围 #

虽然你已经配置了PKG_CONFIG相关变量，但可以额外明确包含Python的pkgconfig文件路径（如果存在的话）：

list(APPEND ENV{PKG_CONFIG_LIBDIR} "${CMAKE_FIND_ROOT_PATH}/usr/share/pkgconfig")

验证配置 #

修改工具链文件后，重新运行CMake配置：

cmake -DCMAKE_TOOLCHAIN_FILE=/path/to/your/toolchain.cmake ..

此时FindPython3应该会通过指定的python3-config工具获取目标系统Python的头文件、库路径等信息，无需手动设置Python3_INCLUDE_DIRS或Python3_LIBRARIES。

补充说明 #

如果目标系统中没有${target_triplet}-python3-config，但有普通的python3-config在${CMAKE_SYSROOT}/usr/bin下，你可以直接将Python3_CONFIG指向该路径。另外，务必确保目标系统的Python开发包（比如python3-dev）已经安装在chroot环境中，否则即使配置正确，CMake也找不到Development.Module所需的组件。

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