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

云原生阿岚

2026-6-1

问题

我参与的软件项目需要适配不同来源（各Linux发行版包、Spack、自行编译等）的不同CMake版本。前提是Python二进制文件已在$PATH中，这在交互或脚本场景下正常，但CMake有时会选择其自身构建时存在的Python版本。

我希望CMake以最直接的方式查找Python：等效于执行which python3并使用该可执行文件。但未找到让find_package(Python3)实现此需求的官方方法——部分平台上set(Python_FIND_STRATEGY LOCATION)曾有效，但系统更新后需切换为set(Python_FIND_STRATEGY VERSION)。

目前我正在评估一个临时解决方案：

execute_process(COMMAND which python3
    OUTPUT_VARIABLE Python3_EXECUTABLE
    OUTPUT_STRIP_TRAILING_WHITESPACE
)
find_package(Python3 COMPONENTS Interpreter REQUIRED)

该方案虽能让CMake像shell一样读取$PATH，但显得繁琐脆弱，易引发长期维护问题。我是否遗漏了文档中关于环境复用的说明？或者这已是CMake能实现的最优方案？

更新：尝试过find_program(Python3_EXECUTABLE python3)，但不够健壮——在which -a python有5个条目的系统中，CMake会忽略首个条目而选择第二个。

解决方案分析

明确指定Python路径的优先级：CMake的find_package(Python3)会优先使用已设置的Python3_EXECUTABLE变量，你当前用execute_process调用which的方案确实能强制CMake使用$PATH中最靠前的Python3，但缺点是依赖which命令的存在（部分极简系统可能没有），且跨平台兼容性差（比如Windows上没有which）。
优化find_program的行为：默认情况下find_program会按$PATH顺序查找，但某些场景下CMake可能因为缓存、系统预设路径优先级等问题跳过首个条目。可以通过设置以下变量强制它严格遵循系统$PATH顺序：
```
set(CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH ON)
set(CMAKE_FIND_USE_CMAKE_PATH OFF)
find_program(Python3_EXECUTABLE NAMES python3 REQUIRED)
find_package(Python3 COMPONENTS Interpreter REQUIRED)
```
这个方案比调用which更跨平台，也更符合CMake的原生逻辑。
关于Python_FIND_STRATEGY的适配：这个变量的行为在不同CMake版本中确实有变化——旧版本中LOCATION策略优先按路径查找，新版本可能调整了优先级。如果需要兼容多CMake版本，可以通过版本判断来设置：
```
if(CMAKE_VERSION VERSION_LESS "3.24")
    set(Python_FIND_STRATEGY LOCATION)
else()
    set(Python_FIND_STRATEGY VERSION)
endif()
find_package(Python3 COMPONENTS Interpreter REQUIRED)
```
不过这种版本分支会增加维护成本，需要根据项目支持的CMake版本范围权衡。
最优方案的选择：如果你的项目主要面向类Unix系统，且依赖which的问题可以接受，当前的execute_process方案能最直接地对齐shell的which行为；如果需要更好的跨平台兼容性，优化后的find_program方案更合适。目前CMake官方确实没有提供完全等效于which的原生参数，所以这两种方案都是当前可行的折中方案。

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