Python模块相对导入

介绍

在Python中，..和...是相对导入的一部分，用于表示当前模块的上层或上上层目录。

示例

例如，如果有以下的目录结构：

project/
│
├── package1/
│   ├── module1.py
│   └── module2.py
│
└── package2/
    ├── subpackage1/
    │   └── module3.py
    └── subpackage2/
        └── module4.py

并且你想在module3.py中导入module1.py，你可以在module3.py中使用以下的导入语句：

from ...package1 import module1

这里，...表示上上层目录（也就是project/），package1是上上层目录下的一个子目录，module1是package1目录下的一个模块。

需要注意的是，相对导入只能用于包内的模块之间，不能用于主脚本。
此外，相对导入依赖于当前模块的名称，如果直接运行模块，Python将其名称设置为__main__，这将导致相对导入失败。因此，相对导入通常用于当你想将你的代码作为一个库来使用时。

常见问题

报错：importError: attempted relative import beyond top-level package
这个错误通常发生在尝试从顶级包之外进行相对导入时。在Python中，相对导入是基于当前模块的名称。

以下是一些可能的解决方案：

1. 确保你正在尝试导入的目录是其自身的包。在Python中，一个文件夹被视为包需要满足两个条件：文件夹中必须有__init__.py文件，且不能作为顶层模块来执行该文件夹中的py文件。
2. 避免在顶层脚本中使用相对导入。相对导入应该在包内的模块之间使用。
3. 调整PYTHONPATH环境变量。PYTHONPATH变量允许你定义在导入模块时要搜索的额外目录。通过将顶级包目录的路径添加到PYTHONPATH，可以使Python正确地定位模块。