TL；博士

您只能相对导入同一包中另一个模块内的模块。

概念澄清

我们在books/docs/articles中看到了很多示例代码，它们向我们展示了如何相对导入模块，但当我们这样做时，它失败了。

原因是，简单地说，我们没有按照python模块机制的预期运行代码，即使代码编写得完全正确。这就像某种运行时的事情。

模块加载取决于您如何运行代码。这就是困惑的根源。

什么是模块？

当且仅当模块被另一个文件导入时，它才是python文件。给定一个文件mod.py，它是一个模块吗？是和否，如果您运行python-mod.py，它不是一个模块，因为它没有导入。

什么是套餐？

包是包含Python模块的文件夹。

顺便说一下，如果您不需要任何包初始化或自动加载子模块，那么python 3.3中不需要__init__.py。您不需要在目录中放置空白__init__.py。

这证明只要有文件被导入，包就只是一个文件夹。

---

真实答案

现在，这个描述变得更加清晰了。

您只能相对导入同一包中另一个模块内的模块。

给定目录：

. CWD
|-- happy_maker.py # content: print('Sends Happy')
`-- me.py # content: from . import happy_maker

运行python-me.py，我们尝试了没有已知父包的相对导入

me.py是直接运行的，它不是一个模块，我们不能在其中使用相对导入。

解决方案1

使用import happy_maker而不是from。导入happy_maker

解决方案2

将工作目录切换到父文件夹。

. CWD
|-- happy
|   |-- happy_maker.py
    `-- me.py

运行python-m happy.me。

当我们在包含happy的目录中时，happy是一个包，me.py，happy_maker.py是模块，我们现在可以使用相对导入，我们仍然希望运行me.py。所以我们使用-m，这意味着将模块作为脚本运行。

---

Python习语

. CWD
|-- happy
|   |-- happy_maker.py # content: print('Sends Happy')
|   `-- me.py # content: from . import happy_maker
`-- main.py # content: import happy.me

这种结构就是python习语。main是我们的脚本，Python中的最佳实践。最后，我们到达了那里。

---

兄弟姐妹或祖父母

另一个常见需求：

.
|-- happy
|   |-- happy_maker.py
|   `-- me.py
`-- sad
    `-- sad_maker.py

我们想在me.py中导入sad_maker，怎么做？

首先，我们需要在同一个包中实现快乐和悲伤，所以我们必须升级到目录级别。然后从。。伤心地在me.py中导入sadmaker。

仅此而已。

我有一个类似的问题：我需要一个Linux服务和cgi插件，它们使用共同的常量来协作。这样做的“自然”方法是将它们放在包的init.py中，但我不能使用-m参数启动cgi插件。

我的最终解决方案与上述解决方案2类似：

import sys
import pathlib as p
import importlib

pp = p.Path(sys.argv[0])
pack = pp.resolve().parent

pkg = importlib.import_module('__init__', package=str(pack))

缺点是必须在常数（或公共函数）前面加上pkg：

print(pkg.Glob)

不幸的是，这个模块需要在包中有时需要作为脚本运行。知道我怎么做吗实现这一目标？

这样的布局很常见。。。

main.py
mypackage/
    __init__.py
    mymodule.py
    myothermodule.py

…有一个mymodule.py像这样。。。

#!/usr/bin/env python3

# Exported function
def as_int(a):
    return int(a)

# Test function for module  
def _test():
    assert as_int('1') == 1

if __name__ == '__main__':
    _test()

…一个肌肉热模块。。。

#!/usr/bin/env python3

from .mymodule import as_int

# Exported function
def add(a, b):
    return as_int(a) + as_int(b)

# Test function for module  
def _test():
    assert add('1', '1') == 2

if __name__ == '__main__':
    _test()

…还有一个像这样的男人。。。

#!/usr/bin/env python3

from mypackage.myothermodule import add

def main():
    print(add('1', '1'))

if __name__ == '__main__':
    main()

…当您运行main.py或mypackage/mymodule.py时，它工作得很好，但由于相对导入，mypackage/myothermodule.py失败。。。

from .mymodule import as_int

你应该用的方式是。。。

python3 -m mypackage.myothermodule

……但它有些冗长，与#/usr/bin/env python3。

对于这种情况，最简单的解决方法是避免使用相对导入，而只使用。。。

from mymodule import as_int

…虽然，如果它不是唯一的，或者您的包结构更复杂，您需要在PYTHONPATH中包含包含您的包目录的目录，并这样做。。。

from mypackage.mymodule import as_int

…或者如果你想让它“开箱即用”，你可以先用这个。。。

import sys
import os

SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
sys.path.append(os.path.dirname(SCRIPT_DIR))

from mypackage.mymodule import as_int

这是一种痛苦，但有一个线索，为什么在一封由某个Guido van Rossum写的电子邮件中。。。

我对这件事和任何其他提议的无聊事都持反对态度__机械唯一的用例似乎是运行发生的脚本生活在模块的目录中，我一直认为反模式。要让我改变主意，你必须说服我它不是。

在包中运行脚本是否是反模式是主观的，但就我个人而言，我发现它在包含一些自定义wxPython小部件的包中非常有用，因此我可以为任何源文件运行脚本，以显示仅包含该小部件的wx.Frame，用于测试目的。

我为Python创建了一个新的实验性导入库：ultraimport

它使程序员能够对导入进行更多的控制，并使其明确无误。此外，当导入失败时，它还会提供更好的错误消息。

它允许您执行相对的、基于文件系统的导入，无论您如何运行代码，也无论您当前的工作目录是什么，这些导入始终有效。运行脚本或模块并不重要。您也不必更改sys.path，这可能会产生其他副作用。

然后你会改变

from .mymodule import myfunction

to

import ultraimport
myfunction = ultraimport('__dir__/mymodule.py', 'myfunction')

这样，即使您将代码作为脚本运行，导入也始终有效。

像这样导入脚本时的一个问题是，后续的相对导入可能会失败。ultraimport有一个内置的预处理器来自动重写相关的导入。

太长，读不下去了通过在python脚本的入口点添加以下内容，将脚本路径附加到系统路径。

import os.path
import sys
PACKAGE_PARENT = '..'
SCRIPT_DIR = os.path.dirname(os.path.realpath(os.path.join(os.getcwd(), os.path.expanduser(__file__))))
sys.path.append(os.path.normpath(os.path.join(SCRIPT_DIR, PACKAGE_PARENT)))

现在，您可以在PyCharma和Terminal中运行项目了！！

对于PyCharm用户：

我还收到了ImportError：尝试在没有已知父包的情况下进行相对导入，因为我正在添加。表示法来消除PyCharm解析错误。PyCharm错误地报告无法找到：

lib.thing导入函数

如果您将其更改为：

.lib.thing导入函数

它会使错误静音，但随后会出现前面提到的ImportError：尝试相对导入，但没有已知的父包。忽略PyCharm的解析器。这是错误的，代码运行良好，尽管它说了什么。