VS2022中CMake忽略指定Python路径，如何强制使用指定版本？

已配置Python3.7的路径相关变量（如Python3_ROOT_DIR、PYTHON_EXECUTABLE等），但CMake在Visual Studio 2022中始终忽略这些配置，自动使用Python3.10的库文件。同一配置在CLion等IDE中可正常工作，如何让VS2022中的CMake强制使用指定的Python版本？

现有CMake配置代码 #

set(PY_VERSION 37)
set(PY_EXE "C:/Program Files/Python37")
set(Python3_ROOT_DIR "C:/Program Files/Python37")
set(Python3_FIND_ABI "ON" "3" "7")
set(PYTHON_EXECUTABLE "${Python3_ROOT_DIR}/python.exe" CACHE FILEPATH "Path to the Python executable")


set(PY_BUILD_DEB)
if (${CMAKE_BUILD_TYPE} MATCHES Debug)
    message("WERE IN DEBUG MODE")
    set(PY_BUILD_DEB "_d")
endif ()
set(_PYTHON_EXECUTABLE "${PY_EXE}/python.exe" CACHE STRING "Path to the Python executable")
set(_PYTHON_INCLUDE_DIR "${PY_EXE}/include" CACHE STRING "Path to the Python include directory")
set(_PYTHON_LIBRARY "${PY_EXE}/libs/python${PY_VERSION}${PY_BUILD_DEB}.lib" CACHE STRING "Path to the Python library")


set(OLD_PATH ${CMAKE_PREFIX_PATH})
set(CMAKE_PREFIX_PATH ${PY_EXE})
find_package(Python REQUIRED COMPONENTS Interpreter Development)# HINTS "${PY_EXE}")

#set(CMAKE_PREFIX_PATH ${PY_BIND_ROOT}/tools)
#find_package(pybind11)

set(CMAKE_PREFIX_PATH ${OLD_PATH})

message("  PYTHON_EXECUTABLE : ${_PYTHON_EXECUTABLE}")
message(" PYTHON_INCLUDE_DIR : ${_PYTHON_INCLUDE_DIR}")
message("     PYTHON_LIBRARY : ${_PYTHON_LIBRARY}")
message("   Python_LIBRARIES : ${Python_LIBRARIES}")
message("Python_INCLUDE_DIRS : ${Python_INCLUDE_DIRS}")

CMake输出结果 #

1> [CMake]    Python_LIBRARIES : optimized;C:/Program Files/Python310/libs/python310.lib;debug;C:/Program Files/Python310/libs/python310_d.lib

解决方案 #

1. 明确指定版本并禁用自动搜索优先级 #

在find_package前添加以下配置，强制CMake优先使用指定版本，跳过系统默认的高版本搜索逻辑：

# 指定Python3.7版本
set(Python3_VERSION_MAJOR 3)
set(Python3_VERSION_MINOR 7)
# 强制优先使用指定路径的Python，而非系统自动查找
set(Python3_FIND_STRATEGY LOCATION)
set(Python_FIND_STRATEGY LOCATION)
# 禁止查找未指定的其他版本
set(Python3_FIND_ANY_VERSION OFF)
set(Python_FIND_ANY_VERSION OFF)

2. 给find_package添加精准路径参数 #

修改find_package命令，直接传入Python3.7的安装路径，并禁用默认搜索路径，确保CMake只检查你指定的位置：

find_package(Python3 REQUIRED COMPONENTS Interpreter Development
             HINTS "C:/Program Files/Python37"
             NO_DEFAULT_PATH)

使用Python3而非Python可以更精准匹配版本；NO_DEFAULT_PATH参数会跳过系统默认的搜索路径，只检查你指定的HINTS路径。

3. 清理VS2022的CMake缓存 #

VS2022会缓存CMake配置结果，旧缓存可能导致修改不生效：

• 打开顶部菜单栏→项目→CMake缓存
• 选择"删除缓存"，然后重新生成CMake配置

4. 手动设置VS2022的CMake命令行参数 #

直接在VS2022的CMake设置中传入指定参数：

• 右键项目→CMake设置→常规→CMake命令行参数
• 添加：-DPython3_ROOT_DIR=C:/Program Files/Python37 -DPYTHON_EXECUTABLE=C:/Program Files/Python37/python.exe
• 应用设置后重新配置CMake

5. 手动指定库和头文件（兜底方案） #

如果以上方法无效，可绕过find_package，直接手动配置路径：

# 手动指定Python3.7的头文件和库
set(Python3_INCLUDE_DIRS "C:/Program Files/Python37/include")
set(Python3_LIBRARIES 
    optimized "C:/Program Files/Python37/libs/python37.lib"
    debug "C:/Program Files/Python37/libs/python37_d.lib")
# 关联到目标项目
include_directories(${Python3_INCLUDE_DIRS})
target_link_libraries(你的目标项目名 PRIVATE ${Python3_LIBRARIES})

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