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。

仅此而已。

这是我的项目结构

├── folder
|   | 
│   ├── moduleA.py
|   |   |
|   |   └--function1()
|   |       └~~ uses function2()
|   | 
│   └── moduleB.py
|       | 
|       └--function2()
|   
└── main.py
     └~~ uses function1()

这里我的模块A导入模块B，主导入模块A

我在模块A中添加了下面的代码段以导入模块B

try:
    from .moduleB import function2 
except:
    from moduleB import function2 

现在我可以单独执行main.py和moduleA.py

这是解决方案吗？

对于PyCharm用户：

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

lib.thing导入函数

如果您将其更改为：

.lib.thing导入函数

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

我遇到了这个问题。黑客解决方法是通过if/else块导入，如下所示：

#!/usr/bin/env python3
#myothermodule

if __name__ == '__main__':
    from mymodule import as_int
else:
    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()

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

这样的布局很常见。。。

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，用于测试目的。

将其放入包的__init__.py文件中：

# For relative imports to work in Python 3.6
import os, sys; sys.path.append(os.path.dirname(os.path.realpath(__file__)))

假设您的包是这样的：

├── project
│   ├── package
│   │   ├── __init__.py
│   │   ├── module1.py
│   │   └── module2.py
│   └── setup.py

现在在您的包中使用常规导入，例如：

# in module2.py
from module1 import class1

这在python 2和3中都有效。