无法使导入与子包一起工作

Question

以下结构（在Python3.7中）不允许我在模块B中导入类A：

package:
    package:
        __init__.py
        a:
            __init__.py
            a.py
        b:
            __init__.py
            b.py

顶层的\uuuu init\uuuu。py为空。以下是剩余的文件：

a

# package/package/a/__init__.py

from .a import A

# package/package/a/a.py

class A:

    def __init__(self):
        pass

b:

# package/package/b/__init__.py

from .b import B

# package/package/b/b.py

from package.a.a import A

class B:

    def __init__(self):
        pass

在Windows上，如果我尝试运行b.py（从b文件夹中）而不做任何其他操作，我会得到以下错误：

ModuleNotFoundError: No module named 'package.a'

如果我在顶层添加一个main.py：

package:
    package:
        __init__.py
        main.py
        a:
            __init__.py
            a.py
        b:
            __init__.py
            b.py

包含

# package/package/main.py

import a
import b

并运行main.py（从包/包内），我得到同样的错误。

如果我将b.py更改为

# package/package/b/b.py

from ..a.a import A

class B:

    def __init__(self):
        pass

然后运行b.py（从b文件夹中）或main。py（从package/package）中，我得到了

ValueError: attempted relative import beyond top-level package

python文档让我觉得我应该能够做到这一点！

有人能解释一下我为什么会犯这些错误吗？我看到过几篇类似的帖子，但它们并没有解决我的问题：

1. 导入子模块Python 3

Answer 1

Python运行的任何模块都称为顶级。

• 在shell中，当您运行

不幸的是（IMO），术语“顶层”在python文档中没有很好的定义，因为它在几个不同的上下文中使用。无论如何，重要的是要理解Python总是将顶级实体的\uuuuu name\uuuu重命名为“\uuuuu main\uuuu”。

PEP 328（在本SO帖子中解释）指出

相对导入使用模块的___属性来确定其在包层次结构中的位置。

由于Python将顶层模块的\uuuu name___重命名为“\u_main____，顶层模块没有包信息，因为它的名称中没有点。

因此，顶级模块不被视为任何包的一部分（尽管它们很可能是！）。换句话说，对于从当前目录导入的包，“\uuuuu main\uuuu”确定什么是顶级的。与“main”处于同一级别的包（在我的示例中是a和b）是顶级包。

令人困惑的是，python文档和PEP 328给出了一个误导性的例子。为相对导入显示的“正确用法”仅在特定上下文中有效。

回想一下，import搜索sys中列出的路径。路径查找要导入的包和模块。当前目录位于sys中。路径，以及指向内置软件包（如math和os）和已安装软件包（即pip安装ed软件包）的路径。Python不会重命名非顶级软件包的___。

因此，python文档和PEP 328示例仅对不在顶级目录中的包和模块有效。

我应该写的是from a. a import A：

# package/package/b/b.py

from a.a import A

class B:

    def __init__(self):
        pass

由于pack位于顶级模块之上，因此尝试进行绝对导入（例如from pack. a. a import a）会导致重要错误即使main.py在包包内部。

也就是说，如果你去PyPI和GitHub看看发布的包，你会发现它们有绝对的导入，比如import-package。a、 a！事实上，如果我发布我的包，并将导入作为a.a导入a，最终用户将获得一个ImportError，因为他们安装了包package，而没有包a！此外，在当前配置中，我无法使用unittest或pytest测试用户可以按预期导入和使用我的包，因为我无法从包中执行。a、 a导入a我自己！

所以问题变成了如何编写和测试自己的定制包？

诀窍是这些包是在开发模式下编写的。要在开发模式下安装您的包，请运行

完成此操作后，python会将您的包视为典型的库包（即pip installed包），因此python不会将其__name__更改为__main__。因此，您可以

• 以绝对进口量进口

开发软件包和独立程序之间的这一关键区别对于大多数初次开发人员（包括我自己）来说都是一个巨大的困惑和挫败源，需要记住这一点非常重要。我希望这个答案能为其他人提供澄清，并在将来添加到文档中。如果这对你有帮助，请在下面的评论中告诉我。

注意：pip安装-e，其中-e代表“可编辑”，将一个链接（a*.pth文件）放在python安装文件夹中，这样该包就被视为已安装的包，但您在其中编写的任何更改都将立即生效（请参阅python打包教程）。因此，您可以使用它来开发自己的软件包，或者根据需要安装和编辑第三方软件包。这需要创建设置。py，但您的所有测试代码、客户端代码等都将能够以通常的方式导入您的包（即，您可以像对待任何其他pip安装ed包一样对待您的包）。通过配置pyproject，您可以使用poetry和flit实现相同的效果。toml文件。

以下是一些其他有用的参考资料：

1. 真蟒蛇。com:Python模块和包-简介
2. 真蟒蛇。com:Python导入：高级技术和技巧
3. 真蟒蛇。com：Python中的绝对导入与相对导入