Python 相对导入的解释[重复]

问题描述：

我实在没办法让 Python 的相对导入功能正常工作。我创建了一个简单的示例来说明它无法正常工作：

目录结构为：

__init__.py
start.py
parent.py
sub/
    __init__.py
    relative.py

/start.py仅包含：import sub.relative

/sub/relative.py仅包含from .. import parent

所有其他文件都是空白的。

在命令行中执行以下操作时：

cd /
python start.py

我得到：

Traceback (most recent call last):
  File "start.py", line 1, in <module>
    import sub.relative
  File "/home/cvondrick/sandbox/sub/relative.py", line 1, in <module>
    from .. import parent
ValueError: Attempted relative import beyond toplevel package

我使用的是 Python 2.6。为什么会出现这种情况？如何让这个沙盒示例正常运行？

解决方案 1：

您正在从包“sub”导入。start.py即使存在，它本身也不在包中__init__.py。

您需要从一个目录启动您的程序parent.py：

./start.py

./pkg/__init__.py
./pkg/parent.py
./pkg/sub/__init__.py
./pkg/sub/relative.py

和start.py：

import pkg.sub.relative

现在 pkg 是顶级包并且您的相对导入应该可以工作。

如果您想保留当前布局，只需使用 即可import parent。由于您使用start.py启动解释器，因此 所在的目录start.py位于您的 Python 路径中。parent.py它作为单独的模块存在那里。

__init__.py如果您没有将任何内容导入目录树上层的脚本，那么您也可以安全地删除顶层。

解决方案 2：

如果您要relative.py直接调用，即如果您确实想从顶级模块导入，则必须将其显式添加到sys.path列表中。

具体操作如下：

# Add this line to the beginning of relative.py file
import sys
sys.path.append('..')

# Now you can do imports from one directory top cause it is in the sys.path
import parent

# And even like this:
from parent import Parent

如果您认为上述方法可能会导致某种不一致，您可以使用以下方法：

sys.path.append(sys.path[0] + "/..")

sys.path[0]指的是入口点运行的路径。

解决方案 3：

在 Python 3 中检查一下：

python -V
Python 3.6.5

例1：

.
├── parent.py
├── start.py
└── sub
    └── relative.py

- start.py
import sub.relative

- parent.py
print('Hello from parent.py')

- sub/relative.py
from .. import parent

如果我们像这样运行它（只是为了确保 PYTHONPATH 为空）：

PYTHONPATH='' python3 start.py

输出：

Traceback (most recent call last):
  File "start.py", line 1, in <module>
    import sub.relative
  File "/python-import-examples/so-example-v1/sub/relative.py", line 1, in <module>
    from .. import parent
ValueError: attempted relative import beyond top-level package

如果我们改变导入sub/relative.py

- sub/relative.py
import parent

如果我们像这样运行它：

PYTHONPATH='' python3 start.py

输出：

Hello from parent.py

例2：

.
├── parent.py
└── sub
    ├── relative.py
    └── start.py

- parent.py
print('Hello from parent.py')

- sub/relative.py
print('Hello from relative.py')

- sub/start.py
import relative
from .. import parent

像这样运行它：

PYTHONPATH='' python3 sub/start.py

输出：

Hello from relative.py
Traceback (most recent call last):
  File "sub/start.py", line 2, in <module>
    from .. import parent
ValueError: attempted relative import beyond top-level package

如果我们改变导入sub/start.py：

- sub/start.py
import relative
import parent

像这样运行它：

PYTHONPATH='' python3 sub/start.py

输出：

Hello from relative.py
Traceback (most recent call last):
  File "sub/start.py", line 3, in <module>
    import parent
ModuleNotFoundError: No module named 'parent'

像这样运行它：

PYTHONPATH='.' python3 sub/start.py

输出：

Hello from relative.py
Hello from parent.py

最好也使用从根文件夹导入，即：

- sub/start.py
import sub.relative
import parent

像这样运行它：

PYTHONPATH='.' python3 sub/start.py

输出：

Hello from relative.py
Hello from parent.py