### 如何在 C++ (Qt6) 程序中集成 Python 脚本扩展 #### 配置环境 为了实现 Qt6 中调用 Python 的功能，需要完成以下几个关键步骤： 1. **在 `.pro` 文件中添加 Python 路径** 在项目的 `.pro` 文件中指定 Python 的库路径以及包含头文件的路径。这可以通过 `LIBS` 和 `INCLUDEPATH` 来设置[^1]。 ```plaintext INCLUDEPATH += /path/to/python/include LIBS += -L/path/to/python/libs -lpython3.x ``` 2. **引入必要的头文件** 使用 Python API 进行交互时，需确保项目能够访问 Python 提供的相关头文件。通常情况下，在源码顶部加入以下内容即可[^1]: ```cpp #include <Python.h> ``` 3. **初始化 Python 解释器并设置主目录** 初始化解释器之前，应先设定 Python 主目录的位置。此操作可通过 `Py_SetPythonHome()` 函数来完成。例如，如果资源被放置于当前工作目录下的子文件夹，则可以这样写[^2]: ```cpp Py_SetPythonHome((wchar_t*)L"./python_env"); ``` 4. **加载和执行脚本** 完成上述准备工作之后，可以在应用程序运行期间动态加载外部 Python 脚本，并通过特定接口传递数据或获取返回值。 #### 实现细节与示例代码 以下是具体实现的一个简化版本例子: ```cpp #include <QCoreApplication> #include <QDebug> #include <Python.h> int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); // 设置 Python Home Py_SetPythonHome((wchar_t *) L"./python_env"); // 初始化 Python 解析器 Py_Initialize(); try { // 加载模块 PyObject* pName = PyUnicode_DecodeFSDefault("example_script"); // 替换为实际脚本名 PyObject* pModule = PyImport_Import(pName); if (!pModule) throw std::runtime_error("Failed to load module."); // 获取函数对象 PyObject* pFunc = PyObject_GetAttrString(pModule, "my_function"); // 替换为目标函数名称 if (!pFunc || !PyCallable_Check(pFunc)) throw std::runtime_error("Cannot find function."); // 构造参数列表 PyObject* args = PyTuple_Pack(1, PyLong_FromLong(42)); // 假设传入整数作为测试输入 // 执行函数调用 PyObject* result = PyObject_CallObject(pFunc, args); if (result != nullptr && PyLong_Check(result)) { qDebug() << "Result:" << PyLong_AsLong(result); // 输出结果到控制台 } else { PyErr_Print(); } // 清理临时变量 Py_XDECREF(args); Py_XDECREF(result); Py_XDECREF(pFunc); Py_XDECREF(pModule); Py_DECREF(pName); } catch (...) { PyErr_Print(); // 如果发生错误则打印异常信息 } // 关闭解析器 Py_Finalize(); return a.exec(); } ``` 注意事项包括但不限于信号槽机制可能引发的问题——即当涉及跨线程通信时可能会导致崩溃现象；因此建议将 `Py_Initialize()` 及其对应的释放过程置于同一上下文中处理以减少潜在风险[^3]。