[toc] Python 相對導入與絕對導入，這兩個概念是相對于包內導入而言的。包內導入即是包內的模塊導入包內部的模塊。 Python2.x 缺省為相對路徑導入，Python3.x 缺省為絕對路徑導入。絕對導入可以避免導入子包覆蓋掉標準庫模塊（由于名字相同，發生沖突）。 ## Python import 的搜索路徑 * 在當前目錄下搜索該模塊 * 在環境變量 PYTHONPATH 中指定的路徑列表中依次搜索 * 在 Python 安裝路徑的 lib 庫中搜索 ## Python import 的步驟 python 所有加載的模塊信息都存放在 sys.modules 結構中，當 import 一個模塊時，會按如下步驟來進行 * 如果是 import A，檢查 sys.modules 中是否已經有 A，如果有則不加載，如果沒有則為 A 創建 module 對象，并加載 A * 如果是 from A import B，先為 A 創建 module 對象，再解析A，從中尋找B并填充到 A 的 \_\_dict\_\_ 中 ## 相對導入與絕對導入 絕對導入的格式為 import A.B 或 from A import B 相對導入格式為 from . import B 或 from ..A import B，.代表當前模塊，..代表上層模塊，...代表上上層模塊，依次類推。 相對導入可以避免硬編碼帶來的維護問題，例如我們改了某一頂層包的名，那么其子包所有的導入就都不能用了。但是存在相對導入語句的模塊，不能直接運行，否則會有異常： `ValueError: Attempted relative import in non-package` * 如果是絕對導入，一個模塊只能導入自身的子模塊或和它的頂層模塊同級別的模塊及其子模塊 * 如果是相對導入，一個**模塊必須有包結構**且**只能導入它的頂層模塊內部的模塊** 所以，**如果一個模塊被直接運行，則它自己為頂層模塊，不存在層次結構，所以找不到其他的相對路徑**，所以如果直接運行python xx.py ，而xx.py有相對導入就會報錯 ### 案例： ``` package ├── __init__.py ├── sub_pkg1 │ ├── __init__.py │ ├── moduleX.py │ ├── moduleY.py └── sub_pkg2 ├── __init__.py └── moduleZ.py` ``` moduleX.py ``` # import moduleY # from sub_pkg1 import moduleY from . import moduleY print "X __name__", __name__ ``` moduleY.py ``` print "Y __name__", __name__ ``` 當我們直接運行 `python sub_pkg1/moduleX.py`的時候，會報錯 ``` ValueError: Attempted relative import in non-package ``` 當我們這樣運行的時候 `python -m sub_pkg1.moduleX`， 才能正常運行 ``` Y __name__ sub_pkg1.moduleY X __name__ __main__ ``` ### 原理解釋 簡單地說，直接運行 .py 文件和 import 這個文件有很大區別。Python 解釋器判斷一個 py 文件屬于哪個 package 時并不完全由該文件所在的文件夾決定。它還取決于這個文件是如何 load 進來的（**直接運行 or import**）。 ### 有兩種方式加載一個 py 文件 * 作為 top-level 腳本 作為 top-level 腳本指的是直接運行腳本，比如 python myfile.py。有且只能有一個 top-level 腳本，就是最開始執行的那個（比如 python myfile.py 中的 myfile.py）。 * 作為 module 作為 module 是指，執行 python -m myfile，或者在其它 py 文件中用 import 語句來加載，那么它就會被當作一個 module。 當一個 py 文件被加載之后，它會被賦予一個名字，保存在` __name__ `屬性中。 如果是 top-level 腳本，那么名字就是` __main__`。 如果是作為 module，名字就是把它所在的 packages/subpackages 和文件名用 . 連接起來,如` package.moduleA`。 所以上面的moduleX的`__name__`是`__main__`， 因為他是直接運行的， moduleY的`__name__`是`sub_pkg1.moduleY`，因為他是被import 來使用的。 ## 總結 **相對導入與絕對導入僅用于包內部,相對與絕對僅針對包內導入而言** 最后再次強調，相對導入與絕對導入僅針對于包內導入而言，要不然本文所討論的內容就沒有意義。**所謂的包，就是包含` __init__.py` 文件的目錄**，該文件在包導入時會被首先執行，該文件可以為空，也可以在其中加入任意合法的 Python 代碼。 相對導入可以避免硬編碼，對于包的維護是友好的。絕對導入可以避免與標準庫命名的沖突。