Python相对导入遇ImportError报错求助：跨子包导入问题

问题分析 #

你的目录结构：

draft
    model
        a.py
    package
        b.py

已给所有目录添加__init__.py，但遇到两个导入错误：

1. 直接运行python package/b.py时，报错ImportError: attempted relative import with no known parent package：Python将package目录识别为顶层包，找不到上层的draft，相对导入..model无效。
2. 运行python -m package.b时，报错ImportError: attempted relative import beyond top-level package：大概率是在draft目录下执行的命令，此时package被当作顶层包，..超出了顶层包范围。

可行解决方案 #

方案1：正确使用-m参数运行 #

确保在**draft的父目录**下执行命令，将draft作为顶层包：
假设目录层级为：

[父目录]
    draft
        __init__.py
        model
            __init__.py
            a.py
        package
            __init__.py
            b.py

在[父目录]下执行：

python -m draft.package.b

此时b.py中的from ..model import a可正常工作——Python将draft识别为顶层包，package和model都是其子包，..会回到draft层级，从而找到model模块。

方案2：使用绝对导入（推荐长期维护项目） #

在b.py中改用基于draft顶层包的绝对导入：

from draft.model import a

再通过动态路径配置让Python自动找到draft包，避免硬编码路径：

import sys
from pathlib import Path

# 动态获取draft的父目录路径并加入sys.path
# __file__是b.py的路径，parent.parent.parent对应到draft的父目录
sys.path.append(str(Path(__file__).parent.parent.parent))

from draft.model import a

只要目录结构不变，迁移到任何电脑都无需手动修改路径。

方案3：将项目安装为可编辑包（适合大型项目） #

在draft的父目录下创建pyproject.toml文件，内容示例：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "draft"
version = "0.1.0"

在该目录下执行：

pip install -e .

之后可在任何地方直接使用from draft.model import a，Python会自动识别这个包，无需手动配置路径。

内容的提问来源于stack exchange，提问作者Sam Bui