最可靠方式是用Python3_ROOT_DIR配合find_package(Python3)，因PYTHON_EXECUTABLE仅控制解释器查找，不涵盖头文件和库路径，而Development组件要求完整环境；Windows下conda/venv安装常缺python3.lib和pyconfig.h，故单设可执行路径易失效。
直接结论：用 Python3_ROOT_DIR 配合 find_package(Python3) 是最可靠、跨平台兼容的方式；Windows 下尤其不能只依赖 PYTHON_EXECUTABLE。
为什么 PYTHON_EXECUTABLE 单独设置经常失效
很多用户在命令行传入 -DPYTHON_EXECUTABLE=/path/to/python3，但 CMake 仍报 Python3Interpreter:NOTFOUND。这是因为：
-
PYTHON_EXECUTABLE只影响 Interpreter 组件的查找，不控制头文件和库路径 -
find_package(Python3)默认需要Interpreter+Development（即头文件和链接库），缺一不可 - Windows 上 conda 或 venv 的 Python 安装不带
python3.lib或pyconfig.h，仅设可执行文件路径无法满足Development要求
Python3_ROOT_DIR 是最稳的指定方式
它告诉 CMake “整个 Python 3 安装根目录在哪”，后续自动推导 include/、lib/、bin/ 等子路径，避免手动拼接错误。
实操建议：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
- Linux/macOS：用 conda 环境路径，例如
set(Python3_ROOT_DIR "/home/user/miniconda3/envs/myenv") - Windows：必须指向 Python 安装根目录（不是 Scripts/ 下的 python.exe），例如
set(Python3_ROOT_DIR "C:/Users/user/anaconda3/envs/myenv") - 务必放在
find_package(Python3 ...)之前，且不要加引号包裹路径（CMake 会自动处理空格） - 推荐写法：
set(Python3_ROOT_DIR "/opt/my-python3.11") find_package(Python3 REQUIRED COMPONENTS Interpreter Development)
命令行传参比写死在 CMakeLists.txt 更灵活
开发时频繁切换 Python 环境，硬编码 set(Python3_ROOT_DIR ...) 易出错。优先用命令行：
cmake -DPython3_ROOT_DIR=/path/to/python3.11 -B build- 若用 conda，先激活环境再运行
which python（Linux/macOS）或where python（Windows），取其父目录作为Python3_ROOT_DIR - 注意：Windows 路径中反斜杠需转义或用正斜杠，
-DPython3_ROOT_DIR=C:/msys64/mingw64可直接用 - 验证是否生效：加
-DCMAKE_FIND_DEBUG_MODE=ON查看日志里实际搜索了哪些路径
Module 模式下找不到 FindPython3.cmake 怎么办
CMake 3.12+ 自带 FindPython3.cmake，但旧版本或精简安装可能缺失。此时：
- 先确认 CMake 版本：
cmake --version；低于 3.12 建议升级 - 若必须用旧版，手动下载官方模块（来自
cmake/Modules/目录），放入项目cmake/子目录 - 然后在
CMakeLists.txt开头加：list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake") - 不要改名 —— 文件必须叫
FindPython3.cmake，大小写敏感
真正容易被忽略的是：即使 Python3_ROOT_DIR 设对了，如果目标环境没装 python3-dev（Debian/Ubuntu）或 python3-devel（RHEL/CentOS），Development 组件依然会失败 —— 这和路径无关，是系统包依赖问题。
