使用importlib动态加载嵌套模块遇ModuleNotFoundError问题求助

我懂你这种动态加载插件时遇到模块导入问题的头疼——我之前也踩过类似的坑。先帮你理清楚问题根源，再给出几种基于importlib的可行方案：

问题根源 #

你的目录结构里，plugin1下的b.py用了import a这种绝对导入，但当你从main.py通过importlib加载b模块时，Python默认不会把plugin1目录加入模块搜索路径（sys.path），也不会自动识别plugin1为一个包，所以b.py里的import a会尝试查找顶级模块a，自然找不到同目录下的a.py。

解决方案 #

方案1：改用相对导入（推荐） #

修改b.py的导入语句为相对导入，让它明确从当前包内加载a模块：

# b.py
from . import a

然后调整main.py里的importlib代码，正确指定包路径：

# main.py
import importlib

plugin = "plugin1"
# 方式1：直接导入完整路径
plugin_module = importlib.import_module(f"plugins.{plugin}.b")

# 方式2：用相对导入语法（需要指定package参数）
# plugin_module = importlib.import_module(".b", package=f"plugins.{plugin}")

这种方式符合Python的包规范，不会污染全局模块路径，是最稳妥的做法。

方案2：临时将插件目录加入sys.path（无需修改插件代码） #

如果没法修改b.py的代码（比如插件是第三方提供的），可以在加载模块前，把plugin1目录临时加入sys.path，让Python能找到同目录下的a：

# main.py
import importlib
import sys
from pathlib import Path

plugin = "plugin1"
# 计算plugin1目录的绝对路径
plugin_dir = Path(__file__).parent.parent / "plugins" / plugin
# 将目录加入sys.path
sys.path.append(str(plugin_dir))

# 现在可以直接导入b，此时b里的import a会找到同目录的a.py
plugin_module = importlib.import_module("b")

⚠️ 注意：这种方法会修改全局的sys.path，如果多个插件目录下有同名模块，可能会引发冲突，仅适合临时场景。

方案3：将plugins转为正规Python包 #

在plugins和plugin1目录下都添加空的__init__.py文件，让它们成为正规的Python包：

├── main
│   └── main.py
└── plugins
    ├── __init__.py
    └── plugin1
        ├── __init__.py
        ├── a.py
        └── b.py

然后就可以用更规范的方式导入插件模块，结合方案1的相对导入，代码会更清晰：

# main.py
import importlib

plugin = "plugin1"
plugin_module = importlib.import_module(f"plugins.{plugin}.b")

额外小提示 #

你原来的代码里有个小笔误："Plugins." + plugin1应该是"plugins." + plugin（变量名是plugin不是plugin1，且目录名是小写的plugins），注意修正避免额外的错误。

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