摘要：詳細(xì)講解了相對路徑和絕對路徑的引用方法。

在某次運(yùn)行過程中出現(xiàn)了如下兩個報錯：

報錯1： ModuleNotFoundError: No module named '__main__.src_test1'; '__main__' is not a package
報錯2： ImportError: attempted relative import with no known parent package

于是基于這兩個報錯探究了一下python3中的模塊相互引用的問題，下面來逐個解析，請耐心看完。

好的，我們先來構(gòu)造第一個錯，測試代碼結(jié)構(gòu)如下：

|--- test_main.py
|--- src
 |--- __init__.py                               
  |--- src_test1.py
  |--- src_test2.py

src_test2.py 代碼

class Test2(object):
  def foo(self):
    print('I am foo')

src_test1.py 代碼，引用Test2模塊

from .src_test2 import Test2
 
def fun1():
  t2 = Test2()
  t2.foo()
if __name__ == "__main__":
  fun1()

此時運(yùn)行 src_test1.py 報錯“No module named '__main__.src_test1'; '__main__' is not a package”

問題原因：

主要在于引用src_test2模塊的時候，用的是相對路徑"."，在import語法中翻譯成"./"，也就是當(dāng)前目錄下，按這樣理解也沒有問題，那為什么報錯呢？

從 PEP 328 中，我們找到了關(guān)于 the relative imports（相對引用）的介紹

通俗一點(diǎn)意思就是，你程序入口運(yùn)行的那個模塊，就默認(rèn)為主模塊，他的name就是‘main'，然后會將本模塊import中的點(diǎn)(.)替換成‘__main__'，那么 .src_test2就變成了 __main__.src_test2，所以當(dāng)然找不到這個模塊了。

解決方法：

因此，建議的做法是在 src同層級目錄創(chuàng)建 引用模塊 test_main.py（為什么不在src目錄下創(chuàng)建，待會下一個報錯再講），并引用src_test1模塊，代碼如下：

from src.src_test1 import fun1
 
if __name__ == "__main__":
  fun1()

那為什么這樣執(zhí)行就可以了呢，其中原理是什么呢？我是這樣理解的（歡迎糾正）：test_main執(zhí)行時，他被當(dāng)做根目錄，因此他引用的src.src_test1 是絕對路徑，這樣引用到哪都不會錯，此時他的name=‘main'，當(dāng)執(zhí)行src_test1的時候，注意了此時test1的name是 src.src_test1，那么在test1中使用的是相對路徑，查找邏輯是先找到父節(jié)點(diǎn)（src目錄），再找父節(jié)點(diǎn)下面的src_test2，因此可以成功找到，Bingo！

輔證：

構(gòu)造一個例子，就可以理解上面的 執(zhí)行目錄就是根目錄 的說法了，修改test1，使引用test_main:

from .. import test_main
 
報錯：ValueError: attempted relative import beyond top-level package

OK，那繼續(xù)構(gòu)造第二個報錯：

上文中說過，解決main 的問題，就是創(chuàng)建一個模塊，來調(diào)用使用相對路徑的模塊，那么為什么我不能在相同目錄下創(chuàng)建這個文件來調(diào)用呢？讓我們來測試下代碼：

創(chuàng)建test_src.py文件，代碼結(jié)構(gòu)變更如下：

|--- test_main.py
|--- src
 |--- __init__.py                               
  |--- src_test1.py
  |--- src_test2.pys
  |--- test_src.py

test_src 代碼:

from src_test1 import fun1
 
if __name__ == "__main__":
  fun1()

執(zhí)行報錯：ImportError: attempted relative import with no known parent package

問題原因：

當(dāng)執(zhí)行test_src時，按上文理解，此時執(zhí)行文件所在的目錄為根目錄，那么引用test1的時候，需要注意的是，此時test1的name屬性不再是src.src_test1，因?yàn)槌绦蚋兄坏絪rc的存在，此時他的絕對路徑是 src_test1，此時再次引用相對路徑查找的test2，同樣的步驟，需要先找到父節(jié)點(diǎn)，而此時他自己就是根節(jié)點(diǎn)了，已經(jīng)沒有父節(jié)點(diǎn)了，因此報錯“no known parent package”。

解決方法：

此時為了避免父節(jié)點(diǎn)產(chǎn)生矛盾，因此將test1中的引入去掉相對引用即可

from .src_test2 import Test2  -->  from src_test2 import Test2

繼續(xù)深入：

那使用相對路徑和絕對路徑，編譯器是怎么找到這個模塊的呢？

執(zhí)行import的時候，存在一個引入的順序，即優(yōu)先查找執(zhí)行目錄下有沒有此文件，如沒有，再查找lib庫下，如還沒有，再查找sys.path中的路徑，如再沒有，報錯。

所以不管是當(dāng)前目錄，還是 sys.path中的目錄，都可以查到 src_test2這個模塊，就可以編譯成功。

號外：

解決完上述問題后，不管我們用哪種方式，我們調(diào)試代碼時，都是單個文件調(diào)試，但此時根目錄就不對了，import方式又要改動，執(zhí)行起來很麻煩，所以這里推薦另一種方式（有更好的方式歡迎留言），使用sys.path.append()的方法

import sys,os
sys.path.append(os.getcwd())
from src.src_test2 import Test2

使用append的方式，將程序文件根目錄放進(jìn)了sys.path中，然后再引用絕對路徑，這樣的方式，不管使用上文中的第一或第二執(zhí)行方式都可以調(diào)用，也可以單獨(dú)編譯test1文件，不用修改import路徑，也是相對安全的方式。但是缺點(diǎn)就是，如果你修改了某一個包名，需要將所有引用地方都修改一下，工作量大，所以因地制宜。

綜上，詳細(xì)講解了相對路徑和絕對路徑的引用方法，現(xiàn)在你應(yīng)該對import導(dǎo)入的問題有了清晰的理解吧

備注：本文基于Python3.7版本測試

到此這篇關(guān)于Python模塊之間的相互引用問題的文章就介紹到這了,更多相關(guān)Python模塊引用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！