Python/C API调用子目录模块时出现ModuleNotFoundError问题求助

这个问题我之前帮人排查过，核心原因就是Python解释器在两种运行方式下的模块搜索路径不一样：
当你在终端用python main.py运行时，Python会自动把当前脚本所在的目录加入到sys.path（模块搜索路径）里，所以同目录、子目录的模块都能被找到；但用PyRun_SimpleFile调用时，默认不会做这个操作，导致解释器找不到那些模块，自然就抛出ModuleNotFoundError了。

下面给你两种实用的解决方案，选哪种看你的需求：

方案一：在C代码中手动添加脚本目录到sys.path #

这种方法不用修改Python代码，直接在C层面处理路径问题，步骤如下：

1. 先获取你要运行的.py文件的绝对路径，提取它所在的目录；
2. 通过Python C API把这个目录插入到sys.path的最前面（保证优先搜索）。

给你写个示例代码，直接能用：

#include <Python.h>
#include <string.h>
#include <libgen.h>

int main() {
    // 初始化Python解释器
    Py_Initialize();

    // 替换成你的Python主文件绝对路径
    const char *py_file_path = "/your/actual/path/main.py";
    
    // 提取文件所在目录
    char dir_path[1024];
    strncpy(dir_path, py_file_path, sizeof(dir_path)-1);
    dirname(dir_path);

    // 更安全的方式：用Python C API操作sys.path，避免路径特殊字符问题
    PyObject *sys_module = PyImport_ImportModule("sys");
    PyObject *path_list = PyObject_GetAttrString(sys_module, "path");
    PyObject *dir_path_obj = PyUnicode_FromString(dir_path);
    // 把目录插入到sys.path的第一个位置，优先搜索
    PyList_Insert(path_list, 0, dir_path_obj);

    // 释放Python对象引用，避免内存泄漏
    Py_DECREF(dir_path_obj);
    Py_DECREF(path_list);
    Py_DECREF(sys_module);

    // 打开并运行Python文件
    FILE *fp = fopen(py_file_path, "r");
    if (fp != NULL) {
        PyRun_SimpleFile(fp, py_file_path);
        fclose(fp);
    } else {
        printf("Failed to open the Python file!\n");
    }

    // 清理Python解释器
    Py_Finalize();
    return 0;
}

方案二：在Python主文件开头添加路径处理 #

如果你不想动C代码，也可以在你的main.py最开头加上这段代码，手动把脚本所在目录加入sys.path：

import sys
import os

# 获取当前脚本的绝对路径所在目录
script_dir = os.path.dirname(os.path.abspath(__file__))
# 确保目录在搜索路径里
if script_dir not in sys.path:
    sys.path.insert(0, script_dir)

这样不管是终端运行还是C调用，模块搜索路径都会是正确的。

另外提个小细节：如果你的子目录里有自定义模块，记得每个子目录下都放一个空的__init__.py文件（Python 3.3+支持无__init__.py的命名空间包，但为了兼容性还是加上更稳妥）。

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