我曾尝试阅读有关兄弟导入的问题，甚至包括包文档，但我仍然没有找到答案。
使用以下结构：
├── 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
如何让 examples 和 tests 目录下的脚本能够从 api 模块导入并且能够从命令行运行？
另外，我想避免为每个文件使用丑陋的 sys.path.insert hack。这在 Python 中肯定有更好的方法，对吗？
虽然有很多sys.path.append的hack方法可用，但我发现了一种解决手边问题的替代方法。
packaged_stuff）setup.py脚本，并在其中使用setuptools.setup()函数。（参见下面最小化的setup.py示例）pip install -e <myproject_folder>命令来安装该包from packaged_stuff.modulename import function_name进行导入起点是您提供的文件结构，放在一个名为myproject的文件夹中。
.
└── myproject
├── api
│ ├── api_key.py
│ ├── api.py
│ └── __init__.py
├── examples
│ ├── example_one.py
│ ├── example_two.py
│ └── __init__.py
├── LICENCE.md
├── README.md
└── tests
├── __init__.py
└── test_one.py
我将把.称为根文件夹，在我的示例中，它位于C:\tmp\test_imports\。
作为测试用例，让我们使用以下路径：./api/api.py
def function_from_api():
return 'I am the return value from api.api!'
from api.api import function_from_api
def test_function():
print(function_from_api())
if __name__ == '__main__':
test_function()
PS C:\tmp\test_imports> python .\myproject\tests\test_one.py
Traceback (most recent call last):
File ".\myproject\tests\test_one.py", line 1, in <module>
from api.api import function_from_api
ModuleNotFoundError: No module named 'api'
使用 from ..api.api import function_from_api 会导致
PS C:\tmp\test_imports> python .\myproject\tests\test_one.py
Traceback (most recent call last):
File ".\tests\test_one.py", line 1, in <module>
from ..api.api import function_from_api
ValueError: attempted relative import beyond top-level package
setup.py 文件setup.py 的内容如下*
from setuptools import setup, find_packages
setup(name='myproject', version='1.0', packages=find_packages())
如果您熟悉虚拟环境，请激活一个并跳过下一步。 虽然不是绝对必需的，但在长期运行中（当您有多个进行中的项目时），它们将真正帮助您。最基本的步骤是（在根文件夹中运行）
python -m venv venvsource ./venv/bin/activate （Linux、macOS）或 ./venv/Scripts/activate（Windows）要了解更多信息，只需谷歌“python 虚拟环境 教程”或类似内容。您可能永远不需要其他命令，除了创建、激活和停用。
一旦您创建并激活了虚拟环境，控制台应该会在括号中显示虚拟环境的名称。
PS C:\tmp\test_imports> python -m venv venv
PS C:\tmp\test_imports> .\venv\Scripts\activate
(venv) PS C:\tmp\test_imports>
你的文件夹树应该看起来像这样**
.
├── myproject
│ ├── api
│ │ ├── api_key.py
│ │ ├── api.py
│ │ └── __init__.py
│ ├── examples
│ │ ├── example_one.py
│ │ ├── example_two.py
│ │ └── __init__.py
│ ├── LICENCE.md
│ ├── README.md
│ └── tests
│ ├── __init__.py
│ └── test_one.py
├── setup.py
└── venv
├── Include
├── Lib
├── pyvenv.cfg
└── Scripts [87 entries exceeds filelimit, not opening dir]
pip install命令安装你的项目，并加上-e选项，这样安装后的包可以编辑。任何对于.py文件的修改都会自动地包含在安装的包中。使用pip命令安装顶层包myproject时，需要添加-e选项，这样它将以可编辑状态安装，所有对.py文件所做的更改都将自动包含在已安装的包中。
在根目录下运行
pip install -e .（注意点号，它表示“当前目录”）
您还可以使用pip freeze命令查看已安装的包。
(venv) PS C:\tmp\test_imports> pip install -e .
Obtaining file:///C:/tmp/test_imports
Installing collected packages: myproject
Running setup.py develop for myproject
Successfully installed myproject
(venv) PS C:\tmp\test_imports> pip freeze
myproject==1.0
myproject.添加到您的导入中请注意，您只需要将myproject.添加到那些否则无法工作的导入中。那些没有使用setup.py和pip install的导入仍然可以正常工作。请参见下面的示例。
现在，让我们使用上面定义的api.py和下面定义的test_one.py来测试解决方案。
from myproject.api.api import function_from_api
def test_function():
print(function_from_api())
if __name__ == '__main__':
test_function()
(venv) PS C:\tmp\test_imports> python .\myproject\tests\test_one.py
I am the return value from api.api!
* 查看setuptools文档获取更详细的setup.py示例。
** 实际上，您可以将虚拟环境放在硬盘上的任何位置。
-e git+https://username@bitbucket.org/folder/myproject.git@f65466656XXXXX#egg=myproject 请问有任何解决办法吗？ - Si MonModuleNotFoundError 的问题吗？我按照以下步骤将 'myproject' 安装在虚拟环境中，但当我进入解释器并运行 import myproject 时，出现了 ModuleNotFoundError: No module named 'myproject'？pip list installed | grep myproject 显示已经安装了它，目录也正确，并且确认了 pip 和 python 的版本号都是正确的。 - ThoseKind自从我写下面的答案以来，修改sys.path仍然是一个快速而有效的技巧，适用于私人脚本，但已经有了一些改进。
setup.cfg存储元数据）-m标志运行作为包也可以（但如果要将工作目录转换为可安装包，则会变得有点笨拙）。sys.path的hack所以这真的取决于你想做什么。在你的情况下，由于似乎你的目标是在某个时候制作一个合适的包，通过pip -e进行安装可能是最好的选择，即使它还不完美。
__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
这里的path[0]是您正在运行的脚本的父文件夹，dir(path[0])是您的顶级文件夹。
尽管如此，我仍然无法使用相对导入，但它确实允许从顶级（例如您的api的父文件夹）进行绝对导入。
__package__ =“examples”的情况下工作。为什么要使用它？2. 在什么情况下__name__ ==“__main__”但__package__不是None？ - actual_panda__packages__ 变量有助于确保绝对路径（如 examples.api）有效，如果我没记错的话（但我已经很久没有这样做了）。检查包是否为 None 大多是为了应对异常情况和未来可能的变化。 - Evpok这里是另一种选择，我将其插入到tests文件夹中的Python文件顶部：
# Path hack.
import sys, os
sys.path.insert(0, os.path.abspath('..'))
.. 在这里是相对于你执行命令的目录而言，而不是包含测试/示例文件的目录。我是在项目目录中执行的，所以我需要使用 ./ 来代替。希望这能帮助其他人。 - user7851115除非必要，否则不需要也不应该去篡改sys.path。在这种情况下，您可以使用：
import api.api_key # in tests, examples
在项目目录下运行：python -m tests.test_one。
如果这些测试是API的单元测试，你应该将tests移动到api中，并运行python -m api.test来运行所有测试（假设存在__main__.py），或者运行python -m api.test.test_one来运行test_one。
你也可以从examples中删除__init__.py（它不是Python包），并在安装了api的虚拟环境中运行示例，例如，在虚拟环境中运行pip install -e .会在原地安装api包，如果你有合适的setup.py。
python -m api.test.test_one。如果您无法配置PyCharm来运行测试，请尝试在Stack Overflow上提出新的问题（如果您找不到关于此主题的现有问题）。 - jfs我还没有足够的Python语言学理解力来看出在不使用兄弟/相对导入hack的情况下在不相关的项目之间共享代码的预期方法。直到那一天，这是我的解决方案。 对于示例或测试从..\api导入东西，它会像这样：
import sys.path
import os.path
# Import from sibling directory ..\api
sys.path.append(os.path.dirname(os.path.abspath(__file__)) + "/..")
import api.api
import api.api_key
pip install -e不自信：简而言之：一个脚本（通常是入口点）只能import与其层级相同或更低的内容。
考虑以下这种层次结构，这是Python 3中的相对导入的建议答案：
MyProject
├── src
│ ├── bot
│ │ ├── __init__.py
│ │ ├── main.py
│ │ └── sib1.py
│ └── mod
│ ├── __init__.py
│ └── module1.py
└── main.py
要从起始点以简单命令 python main.py 运行我们的程序，我们在这里使用绝对导入（没有前导点）在 main.py 中：
from src.bot import main
if __name__ == '__main__':
main.magic_tricks()
文件 bot/main.py 的内容利用了显式相对导入来展示我们正在导入的内容，看起来像这样：
from .sib1 import my_drink # Both are explicit-relative-imports.
from ..mod.module1 import relative_magic
def magic_tricks():
# Using sub-magic
relative_magic(in=["newbie", "pain"], advice="cheer_up")
my_drink()
# Do your work
...
main.py 脚本放置在所有包的根目录 MyProject/src 旁边，并在 python main.py 中使用绝对导入来导入任何内容。没有人会创建名为 src 的包。python -m ...。src/ 下的任何文件作为脚本运行的更多信息？那么您应该使用语法 python -m 并查看我的其他帖子：ModuleNotFoundError: No module named 'sib1'
对于兄弟包导入，您可以使用[sys.path][2]模块的insert或append方法：
if __name__ == '__main__' and if __package__ is None:
import sys
from os import path
sys.path.append( path.dirname( path.dirname( path.abspath(__file__) ) ) )
import api
如果您按照以下方式启动脚本，它将起作用：
python examples/example_one.py
python tests/test_one.py
if __name__ == '__main__' and if __package__ is not None:
import ..api.api
python -m packageName.examples.example_one
python -m packageName.tests.test_one
if __name__ == '__main__':
if __package__ is None:
import sys
from os import path
sys.path.append( path.dirname( path.dirname( path.abspath(__file__) ) ) )
import api
else:
import ..api.api
__file__全局变量，因此我不得不使用以下代码：sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(sys.argv[0]))))。但现在它可以在任何目录下工作了。 - GammaGamesTLDR
这种方法不需要setuptools、路径hack、额外的命令行参数或在项目的每个文件中指定包的顶层。
只需在你要调用的代码所在的父目录中创建一个脚本作为__main__，并从那里运行所有内容。如需进一步解释，请继续阅读。
解释
这可以在不使用hack新路径、额外命令行参数或添加代码来识别兄弟程序的情况下完成。
我认为之前提到的原因是被调用的程序将其__name__设置为__main__。当发生这种情况时，被调用的脚本接受自己位于包的顶层，并拒绝识别兄弟目录中的脚本。
然而，在目录的顶层以下的所有内容仍将识别顶层以下的任何其他内容。这意味着你需要做的唯一一件事就是从它们的父目录中的一个脚本中调用兄弟目录中的文件，以便让它们相互识别/利用。
概念证明 在具有以下结构的目录中：
.
|__Main.py
|
|__Siblings
|
|___sib1
| |
| |__call.py
|
|___sib2
|
|__callsib.py
Main.py 包含以下代码：
import sib1.call as call
def main():
call.Call()
if __name__ == '__main__':
main()
sib1/call.py 包含如下内容：
import sib2.callsib as callsib
def Call():
callsib.CallSib()
if __name__ == '__main__':
Call()
并且sib2/callsib.py包含：
def CallSib():
print("Got Called")
if __name__ == '__main__':
CallSib()
Main.py 会导致 "Got Called" 被打印，正如在 sib2/callsib.py 中定义的那样，即使是通过 sib1/call.py 调用 sib2/callsib.py。然而，如果直接调用 sib1/call.py（在适当更改导入后），它会抛出异常。即使在其父目录中的脚本调用时工作正常，但如果它认为自己处于包的顶层，它也无法工作。examples和tests目录中的脚本能够从api模块导入并且可以从命令行运行？”这个答案不能适用于OP的文件夹结构。 - Niko Pasanenpython main.py调用sib1.call，你可以执行python -m sib1.call。 - Ersel ErImportError: No module named sib1.call。 - Evan Gertis您需要查看相关代码中的导入语句。如果examples/example_one.py使用以下导入语句:
import api.api
如果期望程序在系统中找到项目的根目录，则需要将其添加到系统路径中。
最简单的支持方法（避免使用任何hack技巧）是从项目的顶层目录运行示例，像这样：
PYTHONPATH=$PYTHONPATH:. python examples/example_one.py
$ python examples/example.py Traceback（最近的调用最后）： File“examples/example.py”，第3行，在<module>中 从api.api导入API ImportError：没有名为api.api的模块。我使用import api.api同样得到相同的错误输出。 - zachwillif __name__ == '__main__': import os import sys sys.path.append(os.getcwd())
只要您的工作目录保持在Python项目的根目录下，这似乎非常有效。
sys.path黑科技，阅读到目前为止唯一实际的解决方案（在7年之后！）链接。 - Aran-Fey