我试着通读关于兄弟姐妹导入的问题，甚至 软件包文档，但我还没找到答案。
结构如下:
├── LICENSE.md
├── README.md
├── api
│ ├── __init__.py
│ ├── api.py
│ └── api_key.py
├── examples
│ ├── __init__.py
│ ├── example_one.py
│ └── example_two.py
└── tests
│ ├── __init__.py
│ └── test_one.py
示例和测试目录中的脚本如何从 API模块和从命令行运行?
另外，我希望避免对每个文件都使用难看的sys.path.insert。肯定 这可以在Python中完成，对吧?
当前回答
您需要查看import语句是如何在相关代码中编写的。如果examples/example_one.py使用以下import语句:
import api.api
.．.然后，它期望项目的根目录位于系统路径中。
不需要任何hack(如你所说)就能支持它的最简单的方法就是从顶级目录运行这些例子，就像这样:
PYTHONPATH=$PYTHONPATH:. python examples/example_one.py
其他回答
下面是我在tests文件夹的Python文件顶部插入的另一个替代方案:
# Path hack.
import sys, os
sys.path.insert(0, os.path.abspath('..'))
七年之后
由于我把答案写在下面，修改sys.;Path仍然是一种快速而肮脏的技巧，适用于私有脚本，但是已经有了一些改进
安装包(在virtualenv中或不在virtualenv中)会给你想要的，尽管我建议使用pip来完成，而不是直接使用setuptools(并使用setup.cfg存储元数据) 使用-m标志并作为包运行也可以(但是如果您想将工作目录转换为可安装包，则会有点尴尬)。 具体来说，对于测试，pytest能够在这种情况下找到api包，并负责sys. exe。给你的路径技巧
所以这取决于你想做什么。但是，在您的情况下，由于您的目标似乎是在某种程度上制作一个适当的包，因此通过pip -e安装可能是您的最佳选择，即使它还不完美。
旧的答案
正如在其他地方已经说过的，可怕的事实是，你必须做一些丑陋的hack来允许从__main__模块的兄弟模块或父包导入。该问题在PEP 366中有详细说明。PEP 3122试图以更合理的方式处理导入，但Guido拒绝了它
唯一的用例似乎是运行发生的脚本 在一个模块的目录中，我总是把它看作一个 反模式。
(在这里)
不过，我经常使用这种模式
# Ugly hack to allow absolute import from the root folder
# whatever its name is. Please forgive the heresy.
if __name__ == "__main__" and __package__ is None:
from sys import path
from os.path import dirname as dir
path.append(dir(path[0]))
__package__ = "examples"
import api
这里的路径[0]是运行脚本的父文件夹，目录(路径[0])是顶级文件夹。
虽然我还不能使用相对导入，但它确实允许从顶层(在示例api的父文件夹中)进行绝对导入。
对于主要问题:
调用兄弟文件夹作为模块:
从. .进口siblingfolder
从兄弟文件夹调用a_file.py作为模块:
从. .兄弟文件夹导入a_file
在兄弟文件夹中的文件中调用a_function作为模块:
从. . siblingmodule。A_file import func_name_exists_in_a_file
最简单的方法。
进入lib/site-packages文件夹。
如果存在“easy_install.pth”文件，只需编辑它并添加您有脚本的目录，将其作为模块。
如果不存在，就把它变成一个…把你想要的文件夹放在那里
添加之后…， python会自动将该文件夹视为类似site-packages的文件夹，您可以将该文件夹或子文件夹中的每个脚本作为模块调用。
这是我用手机写的，很难设置成让每个人都能舒服地阅读。
首先，您应该避免使用与模块本身同名的文件。它可能会破坏其他导入。
当你导入一个文件时，解释器首先检查当前目录，然后搜索全局目录。
在示例或测试中，您可以调用:
from ..api import api
您需要查看import语句是如何在相关代码中编写的。如果examples/example_one.py使用以下import语句:
import api.api
.．.然后，它期望项目的根目录位于系统路径中。
不需要任何hack(如你所说)就能支持它的最简单的方法就是从顶级目录运行这些例子，就像这样:
PYTHONPATH=$PYTHONPATH:. python examples/example_one.py
