本文详解解决 modulenotfounderror: 'checks' is not a package 的根本原因，通过显式导入模块 + getattr() 动态获取类的方式，安全、简洁地实现在类方法中动态加载并调用同级模块中的类。
本文详解解决 modulenotfounderror: 'checks' is not a package 的根本原因，通过显式导入模块 + getattr() 动态获取类的方式，安全、简洁地实现在类方法中动态加载并调用同级模块中的类。
在 Python 中，使用 importlib.import_module() 进行动态导入时，路径解析严格依赖于 Python 的模块系统结构。你遇到的错误：
ModuleNotFoundError: No module named 'checks.CheckOne'; 'checks' is not a package
其核心原因在于：checks.py 是一个普通模块（.py 文件），而非包（package） —— 即使你在项目根目录添加了 __init__.py，只要未以包形式被 Python 解释器识别（例如未通过 -m 方式运行或未正确配置 sys.path/PYTHONPATH），importlib.import_module('checks.CheckOne') 就会失败，因为 'checks.CheckOne' 被解析为“子包下的子模块”，而 checks.py 并不包含 CheckOne 子模块。
✅ 正确解法不是强行构造嵌套模块路径，而是先静态导入顶层模块，再用 getattr() 动态提取其中定义的类。这既符合 Python 模块加载机制，又避免路径歧义。
以下是推荐的修复方案（以 database.py 为例）：
import checks # ✅ 显式导入 checks 模块（对应 checks.py）
class Database():
def __init__(self):
self.check_names = ['CheckOne'] # 类名字符串列表
def apply_checks(self):
# ✅ 从已导入的 checks 模块中按名称获取类对象
check_classes = [getattr(checks, name) for name in self.check_names]
# ✅ 实例化并调用方法
for cls in check_classes:
if hasattr(cls, 'apply_') and callable(getattr(cls, 'apply_')):
cls().apply_()
else:
raise AttributeError(f"Class {cls.__name__} missing required method 'apply_'")
? 关键说明与注意事项：
- import checks 成功的前提是：main.py（入口文件）与 checks.py、database.py 处于同一目录，且你直接运行 python main.py（即当前工作目录为 root/）。此时 Python 自动将当前目录加入 sys.path，checks 可被识别为顶层模块。
- ⚠️ 不要删除 __init__.py —— 虽然单文件模块不强制需要它，但添加空的 __init__.py 可显式声明该目录为包，提升可维护性与兼容性（尤其未来扩展为多文件检查模块时）。
- ❌ 避免 importlib.import_module('checks.CheckOne')：CheckOne 是 checks.py 中定义的类，不是独立模块；该写法语义错误，Python 会尝试查找 checks/CheckOne.py 或 checks/__init__.py 中的 CheckOne 子模块，必然失败。
- ✅ getattr(checks, 'CheckOne') 是标准、高效、安全的反射方式，等价于 checks.CheckOne，且支持运行时变量名。
- ? 建议增加类型/属性校验（如示例中所示），防止因拼写错误或类结构变更导致 AttributeError 静默失败。
最终，main.py 保持不变：
from database import Database db = Database() db.apply_checks() # 输出：Performing the first check.
该方案简洁、健壮、符合 Python 惯例，无需修改项目结构或环境变量，是处理同级模块内类动态加载的推荐实践。
