importlib.import_module 不能直接用字符串路径，因为它只接受合法模块名（如os.path），不解析文件系统路径；传入"./plugins/foo.py"会因模块名非法而报错。
importlib.import_module 为什么不能直接用字符串路径
因为 importlib.import_module 接收的是模块名（即 Python 包路径格式），不是文件系统路径。传入 "./plugins/foo.py" 会报 ModuleNotFoundError: No module named './plugins' —— 它按包名解析，不走文件系统。
常见错误现象：把插件脚本路径直接塞给 import_module，结果找不到模块；或者误以为加了 sys.path.append("./plugins") 就能直接导入 "foo"，但没处理模块命名冲突或重复导入问题。
- 必须确保目标文件在 Python 的模块搜索路径中（
sys.path），且文件名符合模块命名规范（如不能含短横线-） - 如果插件是单个
.py文件，推荐用importlib.util.spec_from_file_location+importlib.util.module_from_spec组合，绕过模块名限制 - 模块名建议用插件文件名（不含扩展名）生成，避免硬编码；若同名插件多次加载，需手动清理
sys.modules中的缓存条目
如何安全地从任意文件路径动态加载一个模块
核心是用 importlib.util.spec_from_file_location 构造模块 spec，再用 importlib.util.module_from_spec 实例化模块对象，最后执行 spec.loader.exec_module。
示例：加载 ./plugins/validator.py
import importlib.util
import sys
<p>plugin_path = "./plugins/validator.py"
module_name = "plugins_validator" # 避免与已有模块名冲突</p><p>spec = importlib.util.spec_from_file_location(module_name, plugin_path)
if spec is None:
raise ImportError(f"Cannot load spec from {plugin_path}")</p><p>module = importlib.util.module_from_spec(spec)
sys.modules[module_name] = module # 防止后续重复加载时跳过 exec_module
spec.loader.exec_module(module)</p><h1>现在可以调用 module.validate(...) 等函数</h1><p></p>
- 务必检查
spec是否为None（比如路径不存在、非 Python 文件、权限不足） - 手动注入
sys.modules是为了兼容某些依赖import语句的插件内部逻辑（例如它又去import其他相对模块） - 不要省略
exec_module—— 仅创建 module 对象不会执行模块顶层代码
插件热重载时为什么旧代码还在运行
Python 模块一旦被导入就会缓存在 sys.modules 中，下次 import 或 importlib.import_module 都直接返回缓存对象，不会重新加载。
即使你用 spec.loader.exec_module 再次执行，也只是再次运行模块顶层代码，不会替换已绑定的函数/类引用。
- 要真正重载，必须先从
sys.modules中删掉对应模块项：del sys.modules[module_name] - 还要注意：已有变量仍持旧模块对象的引用（比如
old_validator = module），需显式更新引用 - 若插件内用了
from xxx import yyy，这些导入项不会自动刷新，重载后可能行为不一致 - 生产环境慎用热重载 —— 类型检查、装饰器、全局状态都可能出错，更适合开发期调试
插件模块怎么统一暴露接口而不依赖约定俗成的函数名
靠文档或口头约定 def run() 或 class Plugin 容易出错。更可靠的是定义一个轻量协议，比如要求插件必须有 __plugin__ 属性，值为实现某个 ABC 的实例。
主程序侧定义：
from abc import ABC, abstractmethod <p>class PluginInterface(ABC): @abstractmethod def execute(self, data): ... </p>
插件侧写：
# validator.py from myapp.plugin_interface import PluginInterface <p>class ValidatorPlugin(PluginInterface): def execute(self, data): return isinstance(data, dict)</p><p><strong>plugin</strong> = ValidatorPlugin() # 主程序只认这个变量 </p>
- 主程序加载后检查
hasattr(module, "__plugin__") and isinstance(module.__plugin__, PluginInterface) - 避免用
getattr(module, "run", None)这类松散检查 —— 类型错误晚到运行时才暴露 - 如果插件需初始化参数，可让
__plugin__是 callable，返回实例，比如__plugin__ = lambda config: ValidatorPlugin(config)
插件路径处理、模块缓存清理、接口契约校验——这三处不显眼，但几乎每个动态导入失败案例都卡在这儿。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
