簡述

由于某些原因，在使用 import 時，Python 找不到相應的模塊。這時，解釋器就會發牢騷 - ImportError。

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

python/267320.html">python/280965.html">模塊搜索路徑

當導入名為 hello 的模塊時，解釋器首先搜索具有該名稱的內置模塊。如果沒有找到，將在變量 sys.path 給出的目錄列表中搜索名為 hello.py 的文件。

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

包含輸入腳本的目錄（或當前目錄，當沒有指定文件時）
PYTHONPATH（目錄名列表，與 shell 變量 PATH 語法相同）
與安裝相關的默認值

>>> 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']

注意： '' 表示當前目錄（當前腳本所在的路徑）

例如，在 /home/wang/workspace 中創建一個名為 hello.py 的模塊，內容如下：

print('Hello')

然后，試圖加載該模塊：

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

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

添加模塊搜索路徑

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

1.動態增加路徑

臨時生效，對于不經常使用的模塊，這通常是最好的方式，因為不必用所有次要模塊的路徑來污染 PYTHONPATH。

2.修改 PYTHONPATH 變量

永久生效，對于在許多程序中都使用的模塊，可以采用這種方式。這將改變所有 Python 應用的搜索路徑，因為啟動 Python 時，它會讀取這個變量，甚至不同版本的 Python 都會受影響。

3.增加 .pth 文件

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

動態增加路徑

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

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

現在，查看搜索路徑：

>>> 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 helloHello

可以看到，路徑被成功添加進去了，再次執行導入可以正常使用。

修改 PYTHONPATH 變量

打開并編輯 bashrc：

$ vim ~/.bashrc

將以下內容附加到文件末尾：

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

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

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

增加 .pth 文件

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

/home/wang/workspace

總結

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