如何配置CMake的Python定位器以使用$PATH中的首个python3

你遇到的这个问题在多版本 Python/CMake 环境里非常常见——CMake 的 FindPython3 模块设计初衷是找到符合版本要求的 Python，而非单纯遵循 shell 的 $PATH 顺序，再加上部分CMake版本会优先关联自身构建时依赖的 Python，就会出现和预期不符的情况。下面针对你的需求拆解分析，给出几种可行方案：

一、官方配置方案：用查找策略强制路径优先 #

如果你的CMake版本足够新（3.10+），可以通过组合两个官方变量实现类似 which python3 的行为：

# 告诉CMake不需要匹配特定Python版本，只要是Python3即可
set(Python3_FIND_ANY_VERSION ON)
# 强制优先按路径顺序查找，而非优先匹配版本
set(Python_FIND_STRATEGY LOCATION)

find_package(Python3 COMPONENTS Interpreter REQUIRED)

这个方案的优势是完全基于CMake官方机制，不依赖外部shell命令，维护性更强。如果系统更新后策略失效，大概率是因为PATH中的Python版本不符合CMake默认的版本过滤规则，Python3_FIND_ANY_VERSION 就是用来跳过这个过滤的。

二、最贴合 shell 行为的方案：execute_process + which #

你当前使用的临时方案其实是最能保证和shell行为完全一致的选择，因为 which 会严格遵循 $PATH 顺序返回第一个可执行文件路径。可以稍微优化一下，增加错误处理让它更健壮：

execute_process(
    COMMAND which python3
    OUTPUT_VARIABLE Python3_EXECUTABLE
    OUTPUT_STRIP_TRAILING_WHITESPACE
    RESULT_VARIABLE WHICH_EXIT_CODE
    ERROR_QUIET
)

# 如果which找不到python3，直接终止构建
if(NOT WHICH_EXIT_CODE EQUAL 0)
    message(FATAL_ERROR "python3 not found in system PATH!")
endif()

find_package(Python3 COMPONENTS Interpreter REQUIRED)

这个方案的所谓“繁琐”其实是可控的——你可以把这段逻辑封装成一个CMake函数，放在项目的自定义模块里（比如 cmake/FindSystemPython.cmake），后续只需要调用函数即可，不会增加长期维护成本。

三、为什么 find_program 不够可靠？ #

你提到的 find_program(Python3_EXECUTABLE python3) 失效，本质是因为CMake的find_program逻辑和which不同：

• CMake会额外检查文件是否满足可执行权限、是否符合系统架构等条件；
• 部分系统中，CMake的内部查找路径优先级可能和shell的$PATH不完全同步（比如优先扫描系统默认目录，再扫用户PATH）；
• 如果存在多个版本的python3，CMake可能会优先选择带完整版本号的可执行文件（比如python3.10）而非通用的python3链接。

除非你显式把CMAKE_PROGRAM_PATH设置为shell的$PATH，否则很难让find_program和which结果完全一致，但这样会影响所有后续find_program的行为，风险较高。

总结 #

• 若追求官方优雅性且CMake版本≥3.10：优先用 Python3_FIND_ANY_VERSION + Python_FIND_STRATEGY LOCATION 组合；
• 若必须严格和shell行为一致，或需要兼容旧CMake版本：优化后的execute_process + which方案是最可靠的选择，封装后维护成本很低；
• 避免依赖find_program单独实现，因为它的查找逻辑和shell差异较大。

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