你好,我是 somenzz,可以叫我徵哥。
Python 的import 是非常直覺的,但即使這樣,有時你會發現,明明套件就在那裡,我們仍會遇到ModuleNotFoundError,明明相對路徑非常正確,就是報錯
ImportError: attempted relative import with no known parent package
導入同一個目錄的模組和不同的目錄的模組是完全不同的,本文透過分析使用import 經常遇到的一些問題,來幫助你輕鬆搞定import ,據此,你可以輕鬆創建屬於自己的包。
#模組與套件的關係,可以類比檔案與目錄,模組就是文件。
Python 文件中這樣描述,一個 Python 檔案就是一個模組,Python 的檔案名稱(不帶後綴.py)就是模組名稱。
一個module 可以包含變數、函數和類,它們是該module 定義的命名空間的一部分,因此變數的命名問題不是問題,因為兩個不同的模組可以有同名的變數、函數和類。
模組與套件的關係,可以類比檔案與目錄,套件就是目錄。
package 裡面可以有 module,也可以有子套件(sub-package)。一個模組定義一個命名空間,以便變數、函數和類別可以在兩個不同的模組中具有相同的名稱,同樣的,一個包對其組成的包和模組做同樣的事情,可以透過點號存取主包中的模組和包。
一個基本的 package 可以包含 sub-package、modules、__init__.py(Python 3.3 之後非必要)、setup.py。一個可能的package 結構如下所示:
而setup.py 存在於你的package 所在的主目錄中,包含配置信息,如所需的依賴項、腳本和子包。你也可以指定有關 package 的元數據,例如 package 的名稱、作者、描述等。
setup.py 是 pip 用來安裝你的套件的檔案。
先舉一個簡單的例子,比如說同一個目錄有兩個文件,file1.py 和file2.py,內容很簡單,就列印各自的檔名,不同的是file2.py 裡面import 了file1:
#file1.py print("This is file1.py") #file2.py print("This is file2.py") import file1
運行file2.py 可以得到下面的結果:
❯ python file2.py This is file2.py This is file1.py
可以看出:
我們還要知道 import 的搜尋順序,只需要記住一點,那就是 import 會去 sys.path 裡面搜尋。
例如我在file2.py 的最後加上一行程式碼:import sys; print(sys.path) 就可以列印import 的搜尋路徑:
可以看出sys.path 的順序:
關於sys.path 需要你注意的是:
一旦模組或套件被找到,就會執行該模組或套件。如果套件裡面有初始化檔 __init__.py,導入的時候,會先執行 __init__.py。
然後要導入的項目就被加入到了其命名空間內,我們可以透過 xx.yy 的方式來使用。
先看看什麼是絕對導入,所謂絕對導入就是這樣的形式:
import aa import aa.bb from aa import bb
這樣的方式很直觀, import 會去sys.path 查找就行了,如果遇到了ModuleNotFoundError,思考一下為什麼sys.path 沒有我們要導入的包,或者手動把這個包的路徑插入到sys.path 中去。
再看看什麼是相對導入,所謂相對導入就是這樣的形式:
from . import aa from .aa import bb from .. import yy
也就是說相對路徑中有個. 號,用來表明要導入的模組或當前的包的相對位置。
舉個例子,我們 pythonimportexample 目錄下新建一個目錄 subpackage1,在 subpackage1 內新建兩個檔案 file3.py、file4.py。
內容如下:
file3.py :
print("This is file3.py")
file4.py:
#from . import file3 print("This is file4.py")
只要我们直接运行 file4.py,那是一定会报错的:
Python 提示我们:
ImportError: attempted relative import with no known parent package
也就是说相对导入不知道父包是谁,换句话说,这是一个子包,必须让父包来调用它,直接运行这个文件是不行的,即使你在 file4.py 的目录 subpackage1 同级的目录执行该文件也是不行的,见上图。
但是在 file4.py 的目录 subpackage1 同级的目录作为一个 module 来执行是可以的,如下图:
换句话说,我们把 subpackage1 作为一个包来让别人用,相对导入是可以的,比如说我们在目录 subpackage1 同级的目录新建一个 file5.py 的文件,内容如下:
file5.py:
from subpackage1 import file4。
然后,执行 python file5.py 可以看出,相对导入已经正常工作:
结论
先上一个图来看下目录及引用结构,方块的是目录,椭圆的是文件,曲线是引用:
其中 import_example 目录下有 setup.py 和 run.py
run.py 导入了 file4、file5、file6。
file4 导入了 file3,file5 导入了 file3。
file6 导入了 file2,file2 导入了 file1。
现在我们来执行一下 run.py 看下效果:
可以看出所有相对导入都已正常工作,虽然 file3 被导入了两次,但只执行了一次,说明 Python 内部已经考虑了同一个包的多重导入问题。
自定义包就是让其他文件导入使用的,因此 pythonimportexample目录下都使用相对导入,源代码见:
https://gitee.com/somenzz/code-example/tree/master/import_example
点阅读原文也可以直接访问。
这里还有一些自定义包的例子:
本文分享了什么是模块(module),什么是包(package),import 的搜索路径,也分享了相对导入和绝对导入的区别,最后举了一个非常实用的 import 例子,方便你构建自己的包。
以上是Python 的 import 是怎麼運作的?的詳細內容。更多資訊請關注PHP中文網其他相關文章!