如何让FindPython.cmake识别开发模式下源码编译的Python？

核心问题 #

你在Linux环境下使用了macOS专属的--enable-framework编译参数，且执行了frameworkinstall安装目标，生成的安装目录结构不符合Linux下FindPython.cmake的路径查找规则，这是检测失败的核心原因。

解决步骤 #

1. 重新编译Python，修正编译参数
   首先清理之前的编译残留：

cd /home/ciaran/cpython
sudo make distclean
rm -rf install-python-with-valgrind-options

使用适配Linux的编译配置：

./configure --prefix=$(pwd)/install-python-with-valgrind-options --with-pydebug --without-pymalloc --with-valgrind --enable-shared
make -j$(nproc)
make install

注意：不要加sudo执行install，避免安装目录文件权限被设为root导致当前用户无法读取；新增--enable-shared生成动态库，满足Python扩展开发的链接需求。

2. 先为自定义编译的Python安装依赖
   FindPython.cmake检测的是当前Python环境下的NumPy，系统全局安装的NumPy不生效，需要先给你编译的Python单独安装：

./install-python-with-valgrind-options/bin/pip3 install numpy

3. 调整CMake配置参数
   执行cmake时增加查找策略配置，优先使用指定路径的Python，同时开启debug日志方便排查问题：

cd build
rm -rf *
cmake .. \
-DPython_ROOT_DIR=/home/ciaran/cpython/install-python-with-valgrind-options \
-DPython_FIND_STRATEGY=LOCATION \
-DPython_FIND_DEBUG=ON

如果仍检测失败，可直接强制指定解释器路径，让CMake基于该解释器自动推导头文件、库文件路径：

cmake .. \
-DPython_ROOT_DIR=/home/ciaran/cpython/install-python-with-valgrind-options \
-DPython_EXECUTABLE=/home/ciaran/cpython/install-python-with-valgrind-options/bin/python3 \
-DPython_FIND_STRATEGY=LOCATION

常见排查点 #

• 先手动验证自定义Python可正常执行：/home/ciaran/cpython/install-python-with-valgrind-options/bin/python3 --version
• 确认install-python-with-valgrind-options/lib目录下存在libpython3.xd.so（x对应你编译的Python小版本号，d为debug版本标识）
• 确认install-python-with-valgrind-options/include/python3.xd目录下存在Python头文件

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