我来过这里:

http://www.python.org/dev/peps/pep-0328/http://docs.python.org/2/tutorial/modules.html#packagesPython包:相对导入python相对导入示例代码不起作用python 2.5中的相对导入Python中的相对导入Python:禁用相对导入

还有很多我没有复制的URL,有些在SO上,有些在其他网站上,当时我以为我会很快找到解决方案。

永远重复出现的问题是:我如何解决这个“试图在非包中相对导入”消息?

ImportError: attempted relative import with no known parent package

我在pep-0328上创建了一个完全相同的包副本:

package/
    __init__.py
    subpackage1/
        __init__.py
        moduleX.py
        moduleY.py
    subpackage2/
        __init__.py
        moduleZ.py
    moduleA.py

导入是从控制台完成的。

我确实在相应的模块中创建了名为垃圾邮件和鸡蛋的函数。很自然,它不起作用。答案显然在我列出的第四个URL中,但对我来说都是校友。我访问的一个URL上有这样的回复:

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

上面的回答看起来很有希望,但对我来说都是象形文字。所以我的问题是,如何让Python不返回给我“尝试在非包中相对导入”?据推测,有一个答案涉及-m。

有人能告诉我为什么Python会给出这个错误消息,“非包”是什么意思,为什么以及如何定义“包”,以及准确的答案,让幼儿园的学生很容易理解。


当前回答

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

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

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

其他回答

__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知道顶层在哪里

以下是一个我不建议使用的解决方案,但在某些情况下可能很有用,因为模块根本没有生成:

import os
import sys
parent_dir_name = os.path.dirname(os.path.dirname(os.path.realpath(__file__)))
sys.path.append(parent_dir_name + "/your_dir")
import your_script
your_script.a_function()

根据Lars的建议,我将这种方法包装在一个实验性的新导入库中:ultraimport

它使程序员能够更好地控制导入,并允许基于文件系统的导入。因此,您可以从脚本进行相对导入。父包不是必需的。无论您如何运行代码或当前的工作目录是什么,ultraimport都将始终有效,因为ultraimport使导入变得明确。您不需要更改sys.path,也不需要try/except块来有时执行相对导入,有时执行绝对导入。

然后你可以在somefile.py中写下类似的内容:

import ultraimport
foo = ultraimport('__dir__/foo.py')

__dir__是superimport()的调用程序somefile.py的目录。foo.py将与somefile.py位于同一目录中。

像这样导入脚本时需要注意的一点是,如果它们包含进一步的相对导入。ultraimport有一个内置的预处理器,用于将后续的相对导入重写为ultraimports,以便它们继续工作。尽管如此,由于最初的Python导入是不明确的,所以目前这有点有限,您只能做这么多。