如何在不将Python加入PATH的情况下在C++中调用Python API？

在C应用中嵌入Python解释器，目标是让这个嵌入式实例与设备上其他Python环境完全隔离，无需将其加入系统PATH即可调用API。但当前代码运行后无任何输出（包括C的std::cout内容），仅在手动将Python加入系统PATH时能正常运行。

当前代码如下：

#include <iostream>
#include ".\Python312\include\Python.h"

int main(int argc, char **argv) {
    std::cout << "Starting Python initialization..." << std::endl;

    //Initialize PyPreConfig for early configurations
    PyPreConfig preconfig;
    PyPreConfig_InitIsolatedConfig(&preconfig);  // Initialize for isolated configuration
    preconfig.isolated = 1;   // Enable isolated mode to prevent usage of environment variables

    // Apply the PyPreConfig settings
    PyStatus status = Py_PreInitialize(&preconfig);

    // Initialize PyConfig for detailed interpreter settings
    PyConfig config;
    PyConfig_InitPythonConfig(&config);  // Initialize to default Python configuration

    // Set the Python home directory
    PyConfig_SetString(&config, &config.home, L".\Python312");
    
    // Set the Python executable path
    PyConfig_SetString(&config, &config.executable, L".\Python312\python.exe");

    // set the Python path
    Py_SetPath(L".\Python312\Lib;"
               L".Python312\DLLs");

    // Initialize Python with the configuration
    status = Py_InitializeFromConfig(&config);
    if (PyStatus_Exception(status)) {
        PyErr_Print();  // Print any errors
        PyConfig_Clear(&config);  // Clear configuration on error
        std::cerr << "Failed to initialize Python interpreter with configuration!" << std::endl;
        Py_ExitStatusException(status);  // Exit on error
    }

    if (!Py_IsInitialized()) {
        std::cerr << "Python interpreter not initialized!" << std::endl;
        return 1;
    }

    std::cout << "Python initialized successfully." << std::endl;

    // Execute a simple Python command
    int result = PyRun_SimpleString("print('Hello from full Python installation!')");
    if (result != 0) {
        std::cerr << "Error executing Python code!" << std::endl;
        PyErr_Print();  // Print the Python error to the console
    }

    Py_Finalize();
    PyConfig_Clear(&config);

    std::cout << "Python finalized." << std::endl;
    return 0;
}

核心问题点 #

1. 路径转义错误：Windows路径中的反斜杠\未转义为\\，导致路径字符串解析无效，Python无法找到依赖文件。
2. 初始化状态未检查：Py_PreInitialize调用后未验证返回状态，失败后后续流程会异常。
3. 配置初始化方式错误：使用PyConfig_InitPythonConfig而非隔离模式专属初始化函数，默认配置不符合隔离需求。
4. 标准流不同步：隔离模式下Python与C++的标准输出流可能冲突，导致无输出。

修复后的代码 #

#include <iostream>
#include <fcntl.h>
#include <io.h>
#include ".\Python312\include\Python.h"

int main(int argc, char **argv) {
    // 强制标准输出即时刷新，避免缓冲吞掉日志
    std::cout << std::unitbuf;
    std::cerr << std::unitbuf;

    // Windows下同步C++与Python的标准流编码
    _setmode(_fileno(stdout), _O_U16TEXT);
    _setmode(_fileno(stderr), _O_U16TEXT);

    std::cout << "Starting Python initialization..." << std::endl;

    // 初始化隔离模式预配置
    PyPreConfig preconfig;
    PyPreConfig_InitIsolatedConfig(&preconfig);
    preconfig.isolated = 1;
    preconfig.use_environment = 0; // 明确禁用环境变量读取

    // 检查预初始化状态
    PyStatus status = Py_PreInitialize(&preconfig);
    if (PyStatus_Exception(status)) {
        std::cerr << "Py_PreInitialize failed!" << std::endl;
        Py_ExitStatusException(status);
    }

    // 初始化隔离模式专属配置
    PyConfig config;
    PyConfig_InitIsolatedConfig(&config);

    // 设置路径（注意双反斜杠转义）
    PyConfig_SetString(&config, &config.home, L".\\Python312");
    PyConfig_SetString(&config, &config.executable, L".\\Python312\\python.exe");
    
    // 设置Python依赖路径
    wchar_t py_path[] = L".\\Python312\\Lib;.\\Python312\\DLLs;.";
    PyConfig_SetString(&config, &config.path, py_path);

    // 初始化解释器并检查状态
    status = Py_InitializeFromConfig(&config);
    if (PyStatus_Exception(status)) {
        std::cerr << "Failed to initialize Python interpreter!" << std::endl;
        // 解释器未初始化时用PyStatus_ToString获取错误信息
        std::wcerr << PyStatus_ToString(status) << std::endl;
        PyConfig_Clear(&config);
        Py_ExitStatusException(status);
    }

    if (!Py_IsInitialized()) {
        std::cerr << "Python interpreter not initialized!" << std::endl;
        PyConfig_Clear(&config);
        return 1;
    }

    std::cout << "Python initialized successfully." << std::endl;

    // 执行测试代码
    int result = PyRun_SimpleString("print('Hello from embedded Python!')");
    if (result != 0) {
        std::cerr << "Error executing Python code!" << std::endl;
        PyErr_Print();
    }

    // 安全终止解释器
    Py_FinalizeEx();
    PyConfig_Clear(&config);

    std::cout << "Python finalized." << std::endl;
    return 0;
}

关键修复说明 #

• 路径转义：所有Windows路径中的\改为\\，确保字符串被正确解析。
• 隔离配置初始化：用PyConfig_InitIsolatedConfig替代默认配置初始化，确保环境完全隔离。
• 预初始化检查：添加Py_PreInitialize的错误检查，提前捕获初始化失败。
• 标准流同步：Windows下设置标准流为UTF-16模式，解决Python与C++输出冲突问题。
• 错误信息优化：解释器未初始化时，用PyStatus_ToString获取详细错误（此时PyErr_Print无法工作）。

额外注意事项 #

• 确保Python312目录与C++可执行文件在同一目录，或使用绝对路径。
• Debug版本Python需对应Debug模式编译的C++项目，否则会出现链接错误。
• 隔离模式下，所有依赖必须通过config.path指定，Python不会读取系统环境变量。

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