CMake无法找到Python可执行文件及cl编译器问题排查求助

问题场景 #

我写了一段用于查找Python可执行文件的CMake代码：

find_program(PYTHON python)
if(NOT PYTHON)
    if(MSVC)
        set(PYTHON "python3.12")
    else()
        message(FATAL_ERROR "could not find python executable")
    endif()
endif()
get_filename_component(PYTHON_PATH "${PYTHON}" DIRECTORY)

生成CMake缓存时，抛出错误：

Error CMake Error at C:/Users/himanshu/CMCommon/index_common.cmake:545 (message):
could not find python executable C:/Usershimanshu/CMCommon/index_common.cmake 545

我已经确认Python可执行文件已经添加到环境变量里了。

补充问题：执行他人提供的CMake命令后，又出现编译器相关错误：

CMake Error at CMakeLists.txt:2 (project):
The CMAKE_C_COMPILER:

cl

is not a full path and was not found in the PATH.

To use the NMake generator with Visual C++, cmake must be run from a shell
that can use the compiler cl from the command line. This environment is
unable to invoke the cl compiler. To fix this problem, run cmake from the
Visual Studio Command Prompt (vcvarsall.bat).

Tell CMake where to find the compiler by setting either the environment
variable "CC" or the CMake cache entry CMAKE_C_COMPILER to the full path to
the compiler, or to the compiler name if it is in the PATH.

但直接在Shell里运行CMake命令却能正常执行，该怎么排查这些问题？

一、Python查找失败的排查步骤 #

• 验证环境变量上下文：打开CMake运行的同一个Shell，执行where python（Windows）或which python（Linux/macOS），看能不能输出Python的完整路径。如果这里找不到，说明CMake运行的环境里没加载到Python的环境变量——比如用IDE启动的CMake，试试重启IDE，或者手动在IDE的终端里重新加载环境变量。
• 直接指定Python路径：在CMake命令里加-DPYTHON_EXECUTABLE="C:/实际路径/python.exe"，绕过自动查找逻辑，看看是不是查找规则的问题。
• 扩大查找的名称范围：把find_program改成find_program(PYTHON NAMES python python3 python3.12)，覆盖不同版本的Python可执行文件名，避免因为系统里只有python3而找不到。
• 检查CMake缓存：生成缓存后打开CMakeCache.txt，搜索PYTHON相关变量，看看是不是被其他脚本覆盖了异常值。

二、编译器cl找不到的排查步骤 #

• 核对命令运行上下文：直接在Shell里能跑，说明这个Shell已经通过vcvarsall.bat加载了VS的编译器环境。而执行他人的命令时，可能是在未初始化环境的上下文里（比如IDE内置终端没加载VS环境、批处理脚本没调用vcvarsall.bat）。
• 更换CMake生成器：如果命令里指定了-G "NMake Makefiles"，必须在初始化过VS环境的Shell里运行。可以换成VS自带的生成器，比如-G "Visual Studio 17 2022"，这样CMake会自动找编译器，不用手动初始化环境。
• 显式指定编译器路径：在CMake命令里加-DCMAKE_C_COMPILER="C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.38.33130/bin/Hostx64/x64/cl.exe"（路径根据你的VS版本调整），直接告诉CMake编译器在哪。
• 检查编译器环境变量：在运行CMake的Shell里执行where cl，确认能找到编译器路径。如果找不到，先手动运行vcvarsall.bat x64（对应你的架构）初始化环境，再执行CMake命令。

内容的提问来源于stack exchange，提问作者Himanshu Poddar