qmake构建C++应用时pybind11调用捆绑Python3.7路径错误如何解决

Mac 下动态库默认搜索优先级中系统框架路径高于 App 内置路径，且 Python 解释器初始化时会默认搜索系统路径查找标准库，你当前的配置仅处理了编译时的头文件和链接路径，缺少运行时的路径绑定和解释器路径显式配置，才会出现调用系统 Python 的问题。

更新你的.pro 文件配置如下，新增运行时路径绑定、自动拷贝框架到 App 包的逻辑：

# 编译时框架搜索路径
QMAKE_LFLAGS += -F/$$PWD/../3rdParty/python
# 新增运行时rpath，让可执行文件优先读取App包内的Frameworks目录
QMAKE_LFLAGS += -Wl,-rpath,@executable_path/../Frameworks

# 显式绑定3.7版本的Python框架，避免链接时匹配到系统高版本
LIBS += /$$PWD/../3rdParty/python/Python.framework/Versions/3.7/Python

INCLUDEPATH += $$PWD/../3rdParty/python/Python.framework/Versions/3.7/include/python3.7m
DEPENDPATH += $$PWD/../3rdParty/python/Python.framework/Versions/3.7/include/python3.7m

# 新增构建后自动复制Python.framework到App包的Frameworks目录
FRAMEWORKS.files = $$PWD/../3rdParty/python/Python.framework
FRAMEWORKS.path = Contents/Frameworks
QMAKE_BUNDLE_DATA += FRAMEWORKS

在 pybind11 初始化解释器之前，先调用 Python 原生接口指定内置 Python 的根路径，避免解释器搜索系统路径的标准库：

#include <Python.h>
#include <pybind11/embed.h>
#include <QCoreApplication>
#include <QString>

namespace py = pybind11;

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    // 拼接App包内置Python.framework的根路径
    QString appBinPath = QCoreApplication::applicationDirPath();
    QString pythonHome = appBinPath + "/../Frameworks/Python.framework/Versions/3.7";
    // 显式设置Python Home路径
    Py_SetPythonHome(reinterpret_cast<wchar_t*>(pythonHome.toStdWString().c_str()));

    // 再初始化pybind11解释器
    py::scoped_interpreter guard{};

    // 测试输出，此时sys.exec_prefix应为内置Python路径
    py::print(py::module::import("sys").attr("exec_prefix"));

    return a.exec();
}

• 构建完成后执行otool -L MyApp.app/Contents/MacOS/MyApp检查Python依赖路径，确认显示为@rpath/Python.framework/Versions/3.7/Python而非系统路径。
• 若仍显示系统路径，执行install_name_tool -change [otool输出的系统Python路径] @rpath/Python.framework/Versions/3.7/Python MyApp.app/Contents/MacOS/MyApp手动修正依赖。
• 确保打包的Python.framework包含完整的Versions/3.7/lib/python3.7标准库目录，不要仅拷贝动态库二进制文件。
• 验证时优先在未安装Python3.7的纯净设备上测试，避免本地环境变量干扰。

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