升级QGIS时CMake找到符合要求Python版本但无法调用解释器问题求助

解决步骤 #

1. 彻底清理CMake缓存
   删除编译目录下的CMakeCache.txt文件，或直接新建空的编译目录执行后续操作，避免旧的路径缓存干扰识别逻辑。

2. 替换正确的Python识别参数
   QGIS 3.20使用CMake 3.15+引入的新版FindPython模块检测Python环境，你之前传入的PYTHON_EXECUTABLE是旧版FindPython3模块的参数，新模块不识别，需替换为以下参数：

• -DPython_EXECUTABLE=/usr/local/bin/python3.7 指定解释器路径
• -DPython_INCLUDE_DIR=/usr/local/include/python3.7m 替换为你本地Python3.7对应的头文件目录
• -DPython_LIBRARY=/usr/local/lib/libpython3.7m.so 替换为你本地Python3.7对应的共享库路径
• -DPython_FIND_STRATEGY=LOCATION 强制CMake优先使用你指定的路径搜索，而非优先查找系统默认路径
• -DPython_FIND_VERSION=3.7 强制要求匹配3.7版本的Python，避免识别到系统自带的3.6版本

3. 预加载Python3.7的依赖库路径
   报错提到无法使用指定解释器，大概率是CMake执行时找不到Python3.7的共享库依赖，执行cmake前先在当前终端运行以下命令：

export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

可先运行/usr/local/bin/python3.7 --version确认解释器可正常启动无报错，再执行cmake命令。

完整编译命令示例 #

cmake -DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_INSTALL_PREFIX=/usr/local \
-DWITH_SERVER=ON \
-DPython_EXECUTABLE=/usr/local/bin/python3.7 \
-DPython_INCLUDE_DIR=/usr/local/include/python3.7m \
-DPython_LIBRARY=/usr/local/lib/libpython3.7m.so \
-DPython_FIND_STRATEGY=LOCATION \
-DPython_FIND_VERSION=3.7 \
..

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