CMake配置问题：已检测到Python3.9.6版本却提示未找到

问题描述 #

在Ventura 13.3.1系统上使用CMake（v3.26.0）配置本地Anaconda安装的Python3时，遇到检测异常。配置脚本如下：

find_package(Python3 COMPONENTS Interpreter REQUIRED
             Python3_ROOT "${CMAKE_CURRENT_LIST_DIR}/../conda/bin")

运行时CMake已识别到Python 3.9.6版本，却提示未找到：

CMake Error at /usr/local/Cellar/cmake/3.26.0/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:230 (message):
  Could NOT find Python3 (missing: Python3_ROOT
  /Users/xxx/xxxxx/cmake/../conda/bin) (found version "3.9.6")

错误原因 #

Python3_ROOT是CMake的全局变量，并非find_package命令的关键字参数。你直接将其写入find_package的参数列表中，会被CMake误判为需要查找的组件或无效参数，导致即使找到了Python版本，也因参数格式错误触发REQUIRED的强制报错。

正确配置方式 #

方式1：先设置变量再调用查找命令 #

先单独指定Python3_ROOT变量，再执行find_package：

set(Python3_ROOT "${CMAKE_CURRENT_LIST_DIR}/../conda/bin")
find_package(Python3 COMPONENTS Interpreter REQUIRED)

方式2：用PATHS参数指定查找路径 #

若不想单独设置变量，可直接通过PATHS参数指定Python所在路径，添加NO_DEFAULT_PATH可强制CMake仅在指定路径查找，避免系统自带Python干扰：

find_package(Python3 COMPONENTS Interpreter REQUIRED
             PATHS "${CMAKE_CURRENT_LIST_DIR}/../conda/bin"
             NO_DEFAULT_PATH)

额外验证点 #

• 确认${CMAKE_CURRENT_LIST_DIR}/../conda/bin路径下存在python3或python可执行文件
• 若使用conda虚拟环境，可先通过conda activate <环境名>激活环境，再运行CMake，此时CMake会自动识别当前环境的Python

内容的提问来源于stack exchange，提问作者Professor Nuke