C++嵌入Python时Py_InitializeFromConfig路径配置失败求助

核心问题点 #

你的代码存在三个关键错误，导致路径配置未生效：

1. PyConfig未初始化：传入函数的PyConfig* config未调用PyConfig_InitPythonConfig完成初始化，内存状态异常会导致后续操作失效。
2. PyConfig_Read调用顺序错误：先读取系统配置再修改路径，会让系统默认配置覆盖你的自定义路径设置逻辑。
3. 未正确设置program_name：这个字段是Python定位自身运行环境的核心，缺失会导致默认路径解析异常，进而影响自定义路径的生效。

修正后的代码 #

error_t init_path(PyConfig* config, wchar_t** paths, int num_paths) {
    if (num_paths == 0) {
        return NONE;
    }

    PyStatus status;
    // 1. 初始化PyConfig结构（必须第一步执行）
    PyConfig_InitPythonConfig(config);

    // 2. 设置program_name为你的可执行文件路径
    status = PyConfig_SetString(config, &config->program_name, L"D:/work/projects/common_hdl/pysim/cosim/x64/Debug/cosim.exe");
    if (PyStatus_Exception(status)) {
        fprintf(stderr, "Failed to set program_name\n");
        return PROGRAM_NAME_ERR;
    }

    // 3. 读取系统默认配置（可选，若不需要默认路径可跳过）
    status = PyConfig_Read(config);
    if (PyStatus_Exception(status)) {
        fprintf(stderr, "Failed to read config\n");
        return CONFIG_READ_ERR;
    }

    // 4. 标记使用自定义模块搜索路径
    config->module_search_paths_set = 1;

    // 可选：清空默认路径（仅保留自定义路径时启用）
    // PyWideStringList_Clear(&config->module_search_paths);

    // 5. 添加自定义路径
    for (int i = 0; i < num_paths; i++) {
        status = PyWideStringList_Append(&config->module_search_paths, paths[i]);
        if (PyStatus_Exception(status)) {
            fprintf(stderr, "Could not add path %ls\n", paths[i]);
            return PATH_INSERTION_ERR;
        } else {
            printf("Appending %ls to system path\n", paths[i]);
        }
    }

    // 6. 初始化Python
    status = Py_InitializeFromConfig(config);
    if (PyStatus_Exception(status)) {
        fprintf(stderr, "Unable to initialize python\n");
        return INIT_ERR;
    }

    return NONE;
}

关键说明 #

• PyConfig_InitPythonConfig：必须在使用PyConfig前调用，将所有字段设为标准默认值，是后续操作的基础。
• program_name的作用：Python通过该字段计算运行环境的前缀路径、基础路径，进而确定标准库、site-packages的位置。未设置会导致Python无法正确解析环境，自定义路径也无法正常被识别。
• module_search_paths_set：设为1时，Python会强制使用你指定的module_search_paths，而非自动生成的默认路径。若不设置，即使修改了路径列表也会被忽略。
• PyConfig_Read的取舍：如果不需要系统默认的模块搜索路径（如不想加载site-packages中的第三方库），可以跳过该步骤，直接初始化配置、设置program_name、添加自定义路径后启动Python。

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