如何在CMake的FindPython中隐藏MSYS版本的Python？

针对你的场景，这里有几个可靠的方法让CMake跳过MSYS版本的Python，只使用Windows原生版本，同时兼顾跨平台兼容性：

方法一：利用注册表优先搜索（推荐跨团队协作） #

Windows原生Python安装时会自动写入系统注册表，CMake的FindPython模块支持通过Python3_FIND_REGISTRY变量调整搜索优先级，让它先从注册表查找原生Python，而非优先扫描PATH中的MSYS版本。

在find_package之前添加以下配置：

if(WIN32)
  # 让CMake优先从注册表查找Windows原生Python
  set(Python3_FIND_REGISTRY FIRST)
endif()

find_package(Python3 COMPONENTS Interpreter Development REQUIRED)

这个方法不需要硬编码路径，适配团队成员不同的Python安装位置，其他平台不受影响。

方法二：直接指定Python解释器路径 #

如果你需要固定使用某个特定版本的原生Python，可以直接设置Python3_EXECUTABLE变量，强制CMake使用指定的解释器，后续的开发组件搜索会自动匹配该版本：

方式1：CMake命令行指定（临时生效） #

cmake .. -DPython3_EXECUTABLE="C:/Users/tyler.shellberg/AppData/Local/Programs/Python/Python37/python.exe"

方式2：CMakeLists中配置（永久生效，需加平台判断） #

if(WIN32)
  set(Python3_EXECUTABLE "C:/Users/tyler.shellberg/AppData/Local/Programs/Python/Python37/python.exe")
endif()

find_package(Python3 COMPONENTS Interpreter Development REQUIRED)

注意：如果团队成员的Python路径不同，需要各自调整这个路径，或者通过环境变量传递。

方法三：调整CMAKE_PREFIX_PATH优先级 #

把Windows原生Python的安装根目录加到CMAKE_PREFIX_PATH的最前面，让CMake优先搜索该路径下的Python组件：

if(WIN32)
  # 将原生Python根目录放到搜索路径最前面
  set(CMAKE_PREFIX_PATH "C:/Users/tyler.shellberg/AppData/Local/Programs/Python/Python37" ${CMAKE_PREFIX_PATH})
endif()

find_package(Python3 COMPONENTS Interpreter Development REQUIRED)

这个方法会让CMake优先在指定目录下查找所有依赖，不仅限于Python。

原理说明 #

你的问题根源是MSYS的Python在系统PATH中优先级更高，FindPython先找到了它的解释器，但对应的开发组件不存在（或版本不匹配），而原生Python的开发组件被后续搜索到，导致版本不一致。以上方法都是通过调整CMake的搜索逻辑，让它优先识别Windows原生Python的完整环境。

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