本文详解ImportError: attempted relative import beyond top-level package错误成因，指出根本原因在于目录结构未构成合法的嵌套包层级，并提供符合PEP 328规范的结构重构方案及可移植的执行方式。

本文详解`importerror: attempted relative import beyond top-level package`错误成因，指出根本原因在于目录结构未构成合法的嵌套包层级，并提供符合pep 328规范的结构重构方案及可移植的执行方式。

在Python中，相对导入（如 from ..model import a）并非仅依赖__init__.py文件的存在，而是严格依赖运行时的模块解析上下文。关键规则是：相对导入只能在作为子模块被导入执行（即通过 -m 方式启动）的前提下生效，且其上级层级必须构成一个明确的、顶层的“包命名空间”。

你当前的目录结构：

draft/
├── model/
│   ├── __init__.py
│   └── a.py
└── package/
    ├── __init__.py
    └── b.py

尽管已添加所有__init__.py，但当你执行 python -m package.b 时，Python 将 draft/ 视为工作目录（sys.path[0]），并将 package 和 model 都视为同级的顶层包（top-level packages），而非 package 的父包包含 model。因此 ..model 意味着“向上两级再进入 model”，这已超出实际包层级——故报错 attempted relative import beyond top-level package。

✅ 正确解法：构建清晰的单根包层级结构
将 model 和 package 统一纳入一个共同的父包下，例如：

draft/
└── project/              ← 新增统一根包（必须含 __init__.py）
    ├── __init__.py
    ├── model/
    │   ├── __init__.py
    │   └── a.py
    └── package/
        ├── __init__.py
        └── b.py

此时，在 b.py 中可安全使用：

# package/b.py
from ..model import a  # ✅ 正确：.. 指向 project，model 是 project 的直接子包
# 或更推荐显式导入具体函数
from ..model.a import some_function

然后从 draft/ 目录下执行（确保 draft 在 sys.path 中）：

Secure Python Code Sandbox

安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。

下载

cd draft
python -m project.package.b

⚠️ 注意事项：

• project/ 目录下必须有 __init__.py（即使为空），否则 Python 不识别其为包；
• 绝不可直接运行 python package/b.py —— 此时模块无 __package__ 属性，相对导入必然失败；
• 所有 __init__.py 文件建议保留（兼容 Python
• 此方案完全可移植：无需硬编码路径或修改 sys.path，跨环境零配置。

? 进阶提示：若需在脚本中动态访问同项目其他模块，也可采用绝对导入（推荐）：

# 在 b.py 中
from project.model import a  # 要求 project 在 PYTHONPATH 或已安装为可编辑包

配合 pip install -e .（需在 project/ 下配置 setup.py）可实现更健壮的工程化管理。

归根结底，Python 的包系统设计强调显式结构与明确入口。修复相对导入问题，本质是让目录结构真实反映你的模块依赖逻辑——而非绕过机制强行适配。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！