本文详解如何通过 importlib 动态导入嵌套子目录下的 Python 模块，并正确调用其中的函数，重点解决因缺失 __init__.py 导致的“ModuleNotFoundError”问题。
本文详解如何通过 importlib 动态导入嵌套子目录下的 python 模块，并正确调用其中的函数，重点解决因缺失 __init__.py 导致的“modulenotfounderror”问题。
在 Python 项目中，若需支持用户输入模块名并动态执行（如插件式架构、每日新增脚本等场景），importlib.import_module() 是标准且推荐的方式。但一个常见陷阱是：Python 将仅含 .py 文件的目录视为普通文件夹，而非可导入的包——这正是报错 No module named 'subfolder1.subfolder2.file1' 的根本原因。
✅ 正确结构：确保所有中间目录为合法包
必须在每个层级目录（subfolder1/ 和 subfolder2/）中放置空的 __init__.py 文件（内容可为空），使其成为 Python 包。修正后的项目结构如下：
workspace/ ├── main.py ├── subfolder1/ │ ├── __init__.py # ← 必须存在！ │ └── subfolder2/ │ ├── __init__.py # ← 必须存在！ │ ├── file1.py │ └── file2.py
?
__init__.py的作用是显式声明该目录为 Python 包，使importlib能沿路径解析模块层级。缺少任一__init__.py，路径即中断。
✅ 正确代码：动态导入 + 安全调用
main.py 应严格使用模块名（不含 .py 后缀），并添加健壮性检查：
import importlib
import sys
# 用户输入（示例：file1 或 file2）
user_input = input("Enter filename (e.g., file1 or file2): ").strip()
# 构建完整模块路径（注意：不带 .py 扩展名）
module_path = f"subfolder1.subfolder2.{user_input}"
try:
# 动态导入模块
mod = importlib.import_module(module_path)
# 验证目标函数是否存在
if hasattr(mod, "run") and callable(getattr(mod, "run")):
print(f"[INFO] Running {module_path}.run()...")
mod.run() # 执行函数
else:
print(f"[ERROR] Function 'run' not found or not callable in {module_path}")
except ModuleNotFoundError as e:
print(f"[ERROR] Module not found: {e}. Check spelling and __init__.py files.")
except ImportError as e:
print(f"[ERROR] Failed to import {module_path}: {e}")
except Exception as e:
print(f"[ERROR] Unexpected error in {module_path}: {type(e).__name__}: {e}")
⚠️ 关键注意事项
-
绝不传入
.py后缀：importlib.import_module("subfolder1.subfolder2.file1")✅；...file1.py❌ -
路径必须是点分隔的 Python 包路径，而非文件系统路径（如
./subfolder1/...无效） -
推荐添加
hasattr+callable检查：避免因函数缺失或命名错误导致运行时崩溃 - 若模块路径不在
sys.path中，需提前将workspace目录加入路径（通常main.py所在目录已自动包含）
✅ 进阶提示：支持绝对路径导入（无需修改 sys.path）
若项目结构复杂，也可使用 importlib.util.spec_from_file_location() 加载任意路径的 .py 文件（绕过包约束），但会牺牲模块缓存和相对导入能力，适用于临时脚本场景：
import importlib.util
import os
file_path = os.path.join("subfolder1", "subfolder2", f"{user_input}.py")
if os.path.exists(file_path):
spec = importlib.util.spec_from_file_location(user_input, file_path)
mod = importlib.util.module_from_spec(spec)
spec.loader.exec_module(mod)
mod.run()
综上，动态导入的核心前提是正确的包结构。只要确保 __init__.py 存在于所有父级目录，importlib.import_module() 即可可靠工作，为灵活扩展提供坚实基础。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
