如何在pip包内部导入本地模块并解决ModuleNotFoundError报错

Python导入模块时会按顺序遍历sys.path列表里的所有路径查找目标文件，你遇到的ModuleNotFoundError本质是：安装到系统site-packages目录的pip包X运行时，存放本地包Y的当前工作目录不在模块搜索路径里，动态导入自然找不到目标。

加ipdb断点后能正常导入的原因也很明确：ipdb触发断点中断时，会自动把当前工作目录（即os.getcwd()返回的路径）加到sys.path的最前面，输入c继续执行时，搜索路径已经包含Y所在的目录，所以能导入成功。

另外你贴的示例代码有个笔误：load_module的入参是module_name，但__import__传入的是未定义的package_name，实际使用时要先把变量名统一。

按适配场景从简单到灵活排序：

方案1：导入前主动注入当前工作目录到搜索路径（适配你当前的默认场景） #

直接在动态导入逻辑前，把当前工作目录插入sys.path头部，保证本地目录优先被搜索，代码如下：

import sys
import os

def load_module(module_name: str):
    cwd = os.getcwd()
    # 避免重复添加路径
    if cwd not in sys.path:
        sys.path.insert(0, cwd)
    imported = __import__(module_name)
    return imported

方案2：用标准库importlib实现更规范的动态导入 #

Python3官方推荐使用importlib替代原生__import__做动态导入，行为更稳定可预期，配合路径注入逻辑的实现如下：

import sys
import os
import importlib

def load_module(module_name: str):
    cwd = os.getcwd()
    if cwd not in sys.path:
        sys.path.insert(0, cwd)
    imported = importlib.import_module(module_name)
    return imported

方案3：支持自定义模块路径，不依赖运行时工作目录 #

如果需要更灵活的加载逻辑，可以支持调用方传入本地模块所在的绝对路径，避免因为运行时工作目录变化导致加载失败：

import sys
import os
import importlib

def load_module(module_name: str, module_search_dir: str = None):
    # 未指定搜索目录时默认使用当前工作目录
    target_dir = module_search_dir if module_search_dir else os.getcwd()
    if target_dir not in sys.path:
        sys.path.insert(0, target_dir)
    return importlib.import_module(module_name)

• 本地目录插入sys.path头部时，不要让本地模块名和Python标准库、已安装第三方包重名，否则会覆盖原有模块引发不可预期的错误。
• 如果只是临时加载本地模块，导入完成后可以把之前插入的路径从sys.path中移除，避免污染全局模块搜索空间。

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