我的样板，以使包中的模块具有可独立运行的相对导入。

包/模块.py

## Standalone boilerplate before relative imports
if __package__ is None:                  
    DIR = Path(__file__).resolve().parent
    sys.path.insert(0, str(DIR.parent))
    __package__ = DIR.name

from . import variable_in__init__py
from . import other_module_in_package
...

现在，您可以以任何方式使用模块：

照常运行模块：python-m package.module将其用作模块：python-c“来自包导入模块”独立运行：python package/module.py或者使用shebang（#！/bin/env-python）：package/module.py

NB！如果模块与包同名，则使用sys.path.append而不是sys.path.insert将导致难以跟踪的错误。例如my_script/my_script.py

当然，如果您的包层次结构中有较高级别的相对导入，那么这是不够的，但在大多数情况下，这是可以的。

将要导入的文件移动到外部目录有帮助。当主文件在其自己的目录中生成任何其他文件时，这是非常有用的。前任：之前：

Project  
|---dir1  
|-------main.py  
|-------module1.py  

之后：

Project  
|---module1.py  
|---dir1  
|-------main.py  

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

这样的布局很常见。。。

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所在的目录中不要有-。在发现这样的无意义之后，我从未感到欢欣鼓舞。

如果两个包都在您的导入路径（sys.path）中，并且您想要的模块/类在example.example.py中，那么要访问该类而不进行相对导入，请尝试：

from example.example import fkt

为了避免这个问题，我设计了一个重新包装包装的解决方案，这对我来说已经奏效了一段时间。它将上层目录添加到lib路径：

import repackage
repackage.up()
from mypackage.mymodule import myfunction

使用智能策略（检查调用堆栈），重新打包可以在各种情况下进行相对导入。