脚本与模块

这里有一个解释。简短的版本是，直接运行Python文件和从其他地方导入该文件之间有很大的区别。仅仅知道文件所在的目录并不能决定Python认为它所在的包。这还取决于如何将文件加载到Python中（通过运行或导入）。

有两种方法可以加载Python文件：作为顶级脚本，或作为单元如果您直接执行文件，例如通过在命令行中键入python-myfile.py，文件将作为顶级脚本加载。当在其他文件中遇到import语句时，它将作为模块加载。一次只能有一个顶级脚本；顶级脚本是您运行以启动的Python文件。

命名

加载文件时，会给它一个名称（存储在其__name__属性中）。

如果它作为顶级脚本加载，则其名称为__main__。如果它是作为模块加载的，则其名称为[文件名，前面是它所属的任何包/子包的名称，用点分隔]，例如package.subpackage1.moduleX。

但是要注意，如果使用python-m package.subpackage1.moduleX之类的命令从shell命令行将moduleX作为模块加载，__name__仍然是__main__。

例如，在您的示例中：

package/
    __init__.py
    subpackage1/
        __init__.py
        moduleX.py
    moduleA.py

如果您导入了moduleX（注意：已导入，未直接执行），其名称将为package.subpackage1.moduleX。如果您导入moduleA，其名称为package.moduleA。但是，如果您直接从命令行运行moduleX，其名称则为__main__，如果您从命令行直接运行moduleA，则其名称为__main__。当模块作为顶级脚本运行时，它将失去其正常名称，其名称改为__main__。

不通过包含的软件包访问模块

还有一个问题：模块的名称取决于它是从所在目录“直接”导入还是通过包导入。只有当您在目录中运行Python，并尝试在同一目录（或其子目录）中导入文件时，这才会有所不同。例如，如果您在package/subpackage1目录中启动Python解释器，然后导入moduleX，则moduleX的名称将仅为moduleX而不是package.subpackage1.moduleX。这是因为当以交互方式输入解释器时，Python会将当前目录添加到其搜索路径中；如果在当前目录中找到要导入的模块，它将不知道该目录是包的一部分，包信息也不会成为模块名称的一部分。

一种特殊的情况是，如果您以交互方式运行解释器（例如，只需键入python并立即开始输入python代码）。在本例中，该交互会话的名称为__main__。

这里是错误消息的关键所在：如果模块的名称没有点，则它不被视为包的一部分。文件实际在磁盘上的位置无关紧要。重要的是它的名称，它的名称取决于您如何加载它。

现在看一下您在问题中包含的报价：

相对导入使用模块的name属性来确定该模块在包层次结构中的位置。如果模块的名称不包含任何包信息（例如，它被设置为“main”），则无论模块在文件系统上的实际位置如何，都会像解析顶级模块一样解析相对导入。

相对导入。。。

相对导入使用模块的名称来确定它在包中的位置。使用相对导入时，如从。。导入foo，点表示在包层次结构中增加了一些级别。例如，如果当前模块的名称为package.subpackage1.moduleX，则。。moduleA表示package.moduleA。对于来自..的。。import要工作，模块的名称必须至少有import语句中的点。

…在一个包中只是相对的

但是，如果模块的名称为__main__，则不认为它在包中。它的名称没有点，因此您不能使用from。。import语句。如果您尝试这样做，您将得到“非包中的相对导入”错误。

脚本无法导入相对

您可能做的是尝试从命令行运行moduleX等。当您这样做时，它的名称被设置为__main__，这意味着它内部的相对导入将失败，因为它的名称不会显示它在包中。请注意，如果您从模块所在的同一目录运行Python，然后尝试导入该模块，也会发生这种情况，因为如上所述，Python会“过早”在当前目录中找到模块，而不会意识到它是包的一部分。

还要记住，当您运行交互式解释器时，该交互式会话的“名称”总是__main__。因此，不能直接从交互式会话进行相对导入。相对导入仅用于模块文件中。

两种解决方案：

如果您确实想直接运行moduleX，但仍然希望它被视为包的一部分，那么可以执行python-m package.subpackage1.moduleX。-m告诉python将其作为模块加载，而不是作为顶级脚本加载。或者您实际上不想运行moduleX，只想运行其他脚本，比如myfile.py，它使用moduleX内部的函数。如果是这种情况，请将myfile.py放在其他地方，而不是放在包目录中，然后运行它。如果在myfile.py中，您可以执行类似于从package.moduleA导入垃圾邮件的操作，那么它会正常工作。

笔记

对于这两种解决方案，包目录（示例中的包）必须可以从Python模块搜索路径（sys.path）访问。否则，您将无法可靠地使用包中的任何内容。从Python 2.6开始，模块用于包解析的“名称”不仅由__name__属性决定，还由__package__属性决定。这就是为什么我避免使用显式符号__name__来引用模块的“名称”。由于Python 2.6，模块的“名称”实际上是__package__+'.'+__name__，如果__package__为None，则仅为__name__。）

相对导入使用模块的name属性来确定该模块在包层次结构中的位置。如果模块的名称不包含任何包信息（例如，它被设置为“main”），则无论模块在文件系统上的实际位置如何，都会将相对导入解析为顶级模块。

为PyPi编写了一个小python包，可能有助于了解这个问题。如果希望能够从包/项目中运行包含包含高级包的导入的python文件，而不直接在导入文件的目录中，则该包可以作为变通方法。https://pypi.org/project/import-anywhere/

因此，在与许多其他人一起对此吹毛求疵之后，我在本文中看到了Dorian B发布的一篇笔记，它解决了我在开发用于web服务的模块和类时遇到的具体问题，但我也希望能够在编写代码时使用PyCharm中的调试器工具对它们进行测试。要在自包含的类中运行测试，我将在类文件的末尾包含以下内容：

if __name__ == '__main__':
   # run test code here...

但是如果我想在同一个文件夹中导入其他类或模块，那么我就必须将所有的导入语句从相对表示法更改为本地引用（即删除点（.））。但是在阅读了Dorian的建议后，我尝试了他的“一行”，结果成功了！我现在可以在PyCharm中进行测试，当我在另一个被测试的类中使用该类时，或者当我在web服务中使用它时，我可以将测试代码留在原地！

# import any site-lib modules first, then...
import sys
parent_module = sys.modules['.'.join(__name__.split('.')[:-1]) or '__main__']
if __name__ == '__main__' or parent_module.__name__ == '__main__':
    from codex import Codex # these are in same folder as module under test!
    from dblogger import DbLogger
else:
    from .codex import Codex
    from .dblogger import DbLogger

if语句检查我们是否将此模块作为main运行，或者它是否正在另一个作为main测试的模块中使用。也许这是显而易见的，但我在这里提供了这条注释，以防其他人对上述相关进口问题感到沮丧，可以利用它。

__name__根据所讨论的代码是在全局命名空间中运行还是作为导入模块的一部分运行而改变。

如果代码未在全局空间中运行，__name__将是模块的名称。如果它在全局命名空间中运行——例如，如果您将其键入控制台，或使用python.exe yourscriptnamehere.py将模块作为脚本运行，那么__name__将变为“__main__”。

如果__name__=='__main__'用于测试代码是否从全局命名空间运行，您将看到许多python代码，这允许您拥有一个兼作脚本的模块。

您是否尝试从控制台进行这些导入？

脚本与模块

这里有一个解释。简短的版本是，直接运行Python文件和从其他地方导入该文件之间有很大的区别。仅仅知道文件所在的目录并不能决定Python认为它所在的包。这还取决于如何将文件加载到Python中（通过运行或导入）。

有两种方法可以加载Python文件：作为顶级脚本，或作为单元如果您直接执行文件，例如通过在命令行中键入python-myfile.py，文件将作为顶级脚本加载。当在其他文件中遇到import语句时，它将作为模块加载。一次只能有一个顶级脚本；顶级脚本是您运行以启动的Python文件。

命名

加载文件时，会给它一个名称（存储在其__name__属性中）。

如果它作为顶级脚本加载，则其名称为__main__。如果它是作为模块加载的，则其名称为[文件名，前面是它所属的任何包/子包的名称，用点分隔]，例如package.subpackage1.moduleX。

但是要注意，如果使用python-m package.subpackage1.moduleX之类的命令从shell命令行将moduleX作为模块加载，__name__仍然是__main__。

例如，在您的示例中：

package/
    __init__.py
    subpackage1/
        __init__.py
        moduleX.py
    moduleA.py

如果您导入了moduleX（注意：已导入，未直接执行），其名称将为package.subpackage1.moduleX。如果您导入moduleA，其名称为package.moduleA。但是，如果您直接从命令行运行moduleX，其名称则为__main__，如果您从命令行直接运行moduleA，则其名称为__main__。当模块作为顶级脚本运行时，它将失去其正常名称，其名称改为__main__。

不通过包含的软件包访问模块

还有一个问题：模块的名称取决于它是从所在目录“直接”导入还是通过包导入。只有当您在目录中运行Python，并尝试在同一目录（或其子目录）中导入文件时，这才会有所不同。例如，如果您在package/subpackage1目录中启动Python解释器，然后导入moduleX，则moduleX的名称将仅为moduleX而不是package.subpackage1.moduleX。这是因为当以交互方式输入解释器时，Python会将当前目录添加到其搜索路径中；如果在当前目录中找到要导入的模块，它将不知道该目录是包的一部分，包信息也不会成为模块名称的一部分。

一种特殊的情况是，如果您以交互方式运行解释器（例如，只需键入python并立即开始输入python代码）。在本例中，该交互会话的名称为__main__。

这里是错误消息的关键所在：如果模块的名称没有点，则它不被视为包的一部分。文件实际在磁盘上的位置无关紧要。重要的是它的名称，它的名称取决于您如何加载它。

现在看一下您在问题中包含的报价：

相对导入使用模块的name属性来确定该模块在包层次结构中的位置。如果模块的名称不包含任何包信息（例如，它被设置为“main”），则无论模块在文件系统上的实际位置如何，都会像解析顶级模块一样解析相对导入。

相对导入。。。

相对导入使用模块的名称来确定它在包中的位置。使用相对导入时，如从。。导入foo，点表示在包层次结构中增加了一些级别。例如，如果当前模块的名称为package.subpackage1.moduleX，则。。moduleA表示package.moduleA。对于来自..的。。import要工作，模块的名称必须至少有import语句中的点。

…在一个包中只是相对的

但是，如果模块的名称为__main__，则不认为它在包中。它的名称没有点，因此您不能使用from。。import语句。如果您尝试这样做，您将得到“非包中的相对导入”错误。

脚本无法导入相对

您可能做的是尝试从命令行运行moduleX等。当您这样做时，它的名称被设置为__main__，这意味着它内部的相对导入将失败，因为它的名称不会显示它在包中。请注意，如果您从模块所在的同一目录运行Python，然后尝试导入该模块，也会发生这种情况，因为如上所述，Python会“过早”在当前目录中找到模块，而不会意识到它是包的一部分。

还要记住，当您运行交互式解释器时，该交互式会话的“名称”总是__main__。因此，不能直接从交互式会话进行相对导入。相对导入仅用于模块文件中。

两种解决方案：

如果您确实想直接运行moduleX，但仍然希望它被视为包的一部分，那么可以执行python-m package.subpackage1.moduleX。-m告诉python将其作为模块加载，而不是作为顶级脚本加载。或者您实际上不想运行moduleX，只想运行其他脚本，比如myfile.py，它使用moduleX内部的函数。如果是这种情况，请将myfile.py放在其他地方，而不是放在包目录中，然后运行它。如果在myfile.py中，您可以执行类似于从package.moduleA导入垃圾邮件的操作，那么它会正常工作。

笔记

对于这两种解决方案，包目录（示例中的包）必须可以从Python模块搜索路径（sys.path）访问。否则，您将无法可靠地使用包中的任何内容。从Python 2.6开始，模块用于包解析的“名称”不仅由__name__属性决定，还由__package__属性决定。这就是为什么我避免使用显式符号__name__来引用模块的“名称”。由于Python 2.6，模块的“名称”实际上是__package__+'.'+__name__，如果__package__为None，则仅为__name__。）

一门外语有太多太长的答案。所以我会尽量缩短。

如果你写的是。导入模块，与您所想的相反，模块不会从当前目录导入，而是从包的顶层导入！如果将.py文件作为脚本运行，它根本不知道顶层在哪里，因此拒绝工作。

如果从上面的包目录中像这样启动py-m package.module，那么python知道顶层在哪里