如何配置CMake的Python定位器，使其优先使用$PATH中的第一个python3可执行文件

太懂这种跨多版本CMake、多渠道构建的痛苦了——明明shell里which python3能精准找到想要的版本，到CMake这儿就各种“自作主张”，完全不按套路来。咱们来拆解下这个问题，看看有没有更优雅的解决方式：

问题核心 #

CMake的find_package(Python3)本身带一套自己的查找优先级逻辑，而且不同版本的CMake对Python_FIND_STRATEGY的支持还不稳定：

• 你试过的LOCATION策略，系统更新后就失效，说明CMake内部的查找逻辑随版本调整了
• VERSION策略又会优先匹配版本号，而非严格遵循$PATH的顺序，不符合你要和shell行为对齐的需求

关于你尝试的临时方案 #

用execute_process(COMMAND which python3 ...)确实能1:1复现which的结果，但正如你担心的，这种方式依赖which命令的存在（虽然大部分Linux发行版都有，但不是绝对），而且绕开了CMake本身的查找机制，长期维护起来确实不够优雅，还容易因为环境差异出问题。

另外你提到的find_program(Python3_EXECUTABLE python3)，它的问题在于CMake的find_program有自己的搜索路径优先级，可能会跳过$PATH里的第一个匹配项——这通常是因为CMake缓存了之前的查找结果，或者内部默认包含了一些额外的系统路径，导致和which的行为不一致。

更优雅的官方配置方案 #

其实可以通过调整CMake的搜索规则，让它严格遵循$PATH的顺序，完全不用依赖外部命令：

方案一：调整查找策略与路径优先级 #

# 先清空可能存在的Python缓存，避免旧结果干扰
unset(Python3_EXECUTABLE CACHE)

# 禁用非必要的查找源（Windows/macOS专属，不影响Linux）
set(Python3_FIND_REGISTRY NEVER)
set(Python3_FIND_FRAMEWORK NEVER)

# 强制使用按路径查找的策略
set(Python_FIND_STRATEGY LOCATION)

# 把系统$PATH设为最高优先级的搜索路径
set(CMAKE_PROGRAM_PATH "$ENV{PATH}" ${CMAKE_PROGRAM_PATH})

# 正常调用find_package
find_package(Python3 COMPONENTS Interpreter REQUIRED)

这个方案完全基于CMake官方配置，通过调整搜索路径优先级和查找策略，让CMake的逻辑和shell对齐，没有外部依赖。

方案二：强制指定仅搜索$PATH（兼容更多CMake版本） #

如果某些老版本CMake对Python_FIND_STRATEGY LOCATION支持有问题，可以用更直接的方式锁定$PATH搜索：

unset(Python3_EXECUTABLE CACHE)

# 仅在系统$PATH中查找python3，忽略其他默认路径
find_program(Python3_EXECUTABLE
  NAMES python3 python
  PATHS ENV PATH
  NO_DEFAULT_PATH
)

# 用NO_MODULE参数让CMake基于已找到的可执行文件获取其他信息
find_package(Python3 COMPONENTS Interpreter REQUIRED NO_MODULE)

这里的NO_MODULE会让CMake跳过模块模式的复杂查找，直接用你指定的Python3_EXECUTABLE来关联版本、库路径等信息，稳定性更高。

额外建议 #

如果需要兼容多个CMake版本，可以加个简单的版本判断来切换策略，比如：

if(CMAKE_VERSION VERSION_GREATER_EQUAL "3.19")
  set(Python_FIND_STRATEGY LOCATION)
else()
  # 老版本用find_program的方式
  find_program(Python3_EXECUTABLE NAMES python3 PATHS ENV PATH NO_DEFAULT_PATH)
endif()

比写平台相关的代码要可靠得多。

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