结论：用 pkgutil.iter_modules() 扫描包内模块再配合 importlib.import_module() 动态导入，是 python 插件系统最稳妥的启动方式——但必须手动处理模块命名冲突、导入异常和初始化逻辑。
直接说结论：用 pkgutil.iter_modules() 扫描包内模块，再配合 importlib.import_module() 动态导入，是 Python 插件系统最稳妥的启动方式——但必须手动处理模块命名冲突、导入异常和初始化逻辑。
为什么不能只靠 pkgutil.iter_modules() 就完事？
它只返回模块名和路径信息，不执行导入，也不保证模块能被正确加载。常见错误包括：
-
ImportError: cannot import name 'xxx' from partially initialized module—— 模块里有循环导入或顶层代码依赖未就绪的全局状态 - 同名模块被不同路径下多个插件提供，
sys.modules缓存导致后加载的覆盖前一个 - 插件模块含语法错误或缺失依赖，
iter_modules()完全不报错，直到真正 import 时才崩
如何安全地扫描并导入插件模块？
关键在分两步：先发现，再按需导入，并捕获每个模块的独立异常。示例结构如下（假设插件目录为 plugins/，且已作为包存在）：
plugins/ ├── __init__.py ├── auth_plugin.py └── log_plugin.py
扫描+导入逻辑建议这样写：
- 用
pkgutil.iter_modules(plugins.__path__)获取所有子模块名（不含包前缀） - 拼出完整模块路径：
f"plugins.{name}"，再调用importlib.import_module() - 每个导入必须套
try/except ImportError，失败只跳过该模块，不影响其他 - 导入后检查模块是否定义了约定接口，比如
if hasattr(module, 'register')
插件模块怎么写才能被识别和调用？
不要依赖 __init__.py 自动触发注册；每个插件文件应主动暴露可被调用的入口点。典型写法：
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
# plugins/auth_plugin.py
def register():
print("Auth plugin loaded")
return {"auth": True}
<p>def init(config):</p><h1>可选的初始化逻辑</h1><pre class="brush:python;toolbar:false;">pass
主程序加载后，可统一调用 module.register() 获取功能描述或注册回调。注意：
- 避免在模块顶层执行耗时操作（如连接数据库），放到
init()里更可控 - 如果插件需共享配置，建议通过参数传入，而非读取全局变量
- 模块名不要用下划线开头（
_private.py），iter_modules()默认忽略
容易被忽略的路径和命名陷阱
插件包必须是一个合法 Python 包（含 __init__.py），且其父目录需在 sys.path 中。否则 iter_modules() 返回空列表，连错误都不报。
- 动态添加路径要用
sys.path.insert(0, "/path/to/plugins")，而不是append—— 防止同名包被标准库或第三方包覆盖 - 模块名不能是 Python 关键字（如
class.py），也不能含非 ASCII 字符或空格 - Windows 下路径大小写不敏感，但 Linux 下
Plugins/和plugins/被视为不同包，务必保持一致
真正麻烦的不是扫描，而是确保每个插件模块在独立上下文中初始化、不污染全局状态、能被卸载（如果需要）。这些得靠设计约束，pkgutil 本身不解决。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
