簡述

由于某些原因，在使用 import 時(shí)，Python 找不到相應(yīng)的模塊。這時(shí)，解釋器就會(huì)發(fā)牢騷 - ImportError。

那么，Python 如何知道在哪里搜索模塊的路徑呢？

模塊搜索路徑

當(dāng)導(dǎo)入名為 hello 的模塊時(shí)，解釋器首先搜索具有該名稱的內(nèi)置模塊。如果沒有找到，將在變量 sys.path 給出的目錄列表中搜索名為 hello.py 的文件。

sys.path 從這些位置初始化：

包含輸入腳本的目錄（或當(dāng)前目錄，當(dāng)沒有指定文件時(shí)）
PYTHONPATH（目錄名列表，與 shell 變量 PATH 語法相同）
與安裝相關(guān)的默認(rèn)值

>>> import sys
>>> sys.path
['', '/usr/local/lib/python35.zip', '/usr/local/lib/python3.5', '/usr/local/lib/python3.5/plat-linux',
 '/usr/local/lib/python3.5/lib-dynload', '/usr/local/lib/python3.5/site-packages']

注意： '' 表示當(dāng)前目錄（當(dāng)前腳本所在的路徑）

例如，在 /home/wang/workspace 中創(chuàng)建一個(gè)名為 hello.py 的模塊，內(nèi)容如下：

print('Hello')

然后，試圖加載該模塊：

>>> import os
>>> 
>>> os.getcwd() # 獲取當(dāng)前目錄
'/home/wang'
>>> 
>>> import hello.py
...
ImportError: No module named 'hello'

很遺憾，由于 sys.path 中沒有包含 /home/wang/workspace 這個(gè)路徑，所以找不到 hello 模塊，從而引發(fā) ImportError。

添加模塊搜索路徑

為了解決上述問題，需要添加模塊搜索路徑，可以使用以下幾種方式：

1.動(dòng)態(tài)增加路徑

臨時(shí)生效，對(duì)于不經(jīng)常使用的模塊，這通常是最好的方式，因?yàn)椴槐赜盟写我K的路徑來污染 PYTHONPATH。

2.修改 PYTHONPATH 變量

永久生效，對(duì)于在許多程序中都使用的模塊，可以采用這種方式。這將改變所有 Python 應(yīng)用的搜索路徑，因?yàn)閱?dòng) Python 時(shí)，它會(huì)讀取這個(gè)變量，甚至不同版本的 Python 都會(huì)受影響。

3.增加 .pth 文件

永久生效，這是最簡單的、也是推薦的方式。Python 在遍歷已知的庫文件目錄過程中，如果遇到 .pth 文件，便會(huì)將其中的路徑加入到 sys.path 中，于是 .pth 中所指定的路徑就可以被 Python 運(yùn)行環(huán)境找到了。

動(dòng)態(tài)增加路徑

通過 sys 模塊的 append() 方法在 Python 環(huán)境中增加搜索路徑：

>>> import sys
>>> sys.path.append('/home/wang/workspace')

現(xiàn)在，查看搜索路徑：

>>> sys.path
['', '/usr/local/lib/python35.zip', '/usr/local/lib/python3.5', '/usr/local/lib/python3.5/plat-linux',
 '/usr/local/lib/python3.5/lib-dynload', '/usr/local/lib/python3.5/site-packages', '/home/wang/workspace']
>>> 
>>> import hello
Hello

可以看到，路徑被成功添加進(jìn)去了，再次執(zhí)行導(dǎo)入可以正常使用。

修改 PYTHONPATH 變量

打開并編輯 bashrc：

$ vim ~/.bashrc

將以下內(nèi)容附加到文件末尾：

export PYTHONPATH=$PYTHONPATH:/home/wang/workspace

不要忘記重新加載 shell，方法是退出并重新啟動(dòng)，或者在命令行重新加載配置文件：

$ source ~/.bashrc # 或者 . ~/.bashrc 

增加 .pth 文件

在 /usr/local/lib/python3.5/site-packages 下添加一個(gè)擴(kuò)展名為 .pth 的配置文件（例如：extras.pth），內(nèi)容為要添加的路徑：

/home/wang/workspace

總結(jié)

以上就是本文關(guān)于Python模塊搜索路徑代碼詳解的全部內(nèi)容，希望對(duì)大家有所幫助。感興趣的朋友可以繼續(xù)參閱本站其他相關(guān)專題，如有不足之處，歡迎留言指出。感謝朋友們對(duì)本站的支持！