作者：豌豆花下貓

在寫 Python 項目的時候，我們可能經常會遇到導入模塊失敗的錯誤：ImportError: No module named 'xxx'或者ModuleNotFoundError: No module named 'xxx'。

導入失敗問題，通常分為兩種：一種是導入自己寫的模塊(即以 .py 為后綴的文件)，另一種是導入三方庫。本文主要討論第二種情況，今后有機會，我們再詳細討論其它的相關話題。

解決導入 Python 庫失敗的問題，其實關鍵是在運行環境中裝上缺失的庫(注意是否是虛擬環境)，或者使用恰當的替代方案。這個問題又分為三種情況：

一、單個模塊中缺失的庫

在編寫代碼的時候，如果我們需要使用某個三方庫(如 requests)，但不確定實際運行的環境是否裝了它，那么可以這樣：

try:importrequestsexceptImportError:importos

os.system('pip install requests')import requests

這樣寫的效果是，如果找不到 requests 庫，就先安裝，再導入。

在某些開源項目中，我們可能還會看到如下的寫法(以 json 為例)：

try:importsimplejson as jsonexceptImportError:import json

這樣寫的效果是，優先導入三方庫 simplejson，如果找不到，那就使用內置的標準庫 json。

這種寫法的好處是不需要導入額外的庫，但它有個缺點，即需要保證那兩個庫在使用上是兼容的，如果在標準庫中找不到替代的庫，那就不可行了。

如果真找不到兼容的標準庫，也可以自己寫一個模塊(如 my_json.py)，實現想要的東西，然后在 except 語句中導入它。

try:importsimplejson as jsonexceptImportError:import my_json as json

二、整個項目中缺失的庫

以上的思路是針對開發中的項目，但是它有幾個不足：1、在代碼中對每個可能缺失的三方庫都 pip install，并不可取；2、某個三方庫無法被標準庫或自己手寫的庫替代，該怎么辦？3、已成型的項目，不允許做這些修改怎么辦？

所以這里的問題是：有一個項目，想要部署到新的機器上，它涉及很多三方庫，但是機器上都沒有預裝，該怎么辦？

對于一個合規的項目，按照約定，通常它會包含一個“requirements.txt?”文件，記錄了該項目的所有依賴庫及其所需的版本號。這是在項目發布前，使用命令pip freeze > requirements.txt?生成的。

使用命令pip install -r requirements.txt?(在該文件所在目錄執行，或在命令中寫全文件的路徑)，就能自動把所有的依賴庫給裝上。

但是，如果項目不合規，或者由于其它倒霉的原因，我們沒有這樣的文件，又該如何是好？

一個笨方法就是，把項目跑起來，等它出錯，遇到一個導庫失敗，就手動裝一個，然后再跑一遍項目，遇到導庫失敗就裝一下，如此循環……(此處省略 1 萬句臟話)……

三、自動導入任意缺失的庫

有沒有一種更好的可以自動導入缺失的庫的方法呢？

在不修改原有的代碼的情況下，在不需要“requirements.txt”文件的情況下，有沒有辦法自動導入所需要的庫呢？

當然有！先看看效果：

我們以 tornado 為例，第一步操作可看出，我們沒有裝過 tornado，經過第二步操作后，再次導入 tornado 時，程序會幫我們自動下載并安裝好 tornado，所以不再報錯。

autoinstall 是我們手寫的模塊，代碼如下：

#以下代碼在 python 3.6.1 版本驗證通過

importsysimportosfrom importlib importimport_moduleclassAutoInstall():

_loaded=set()

@classmethoddef find_spec(cls, name, path, target=None):if path is None and name not incls._loaded:

cls._loaded.add(name)print("Installing", name)try:

result= os.system('pip install {}'.format(name))if result ==0:returnimport_module(name)exceptException as e:print("Failed", e)returnNone

sys.meta_path.append(AutoInstall)

這段代碼中使用了sys.meta_path?，我們先打印一下，看看它是個什么東西？

Python 3 的 import 機制在查找過程中，大致順序如下：

在 sys.modules 中查找，它緩存了所有已導入的模塊

在 sys.meta_path 中查找，它支持自定義的加載器

在 sys.path 中查找，它記錄了一些庫所在的目錄名

若未找到，拋出ImportError異常

其中要注意，sys.meta_path 在不同的 Python 版本中有所差異，比如它在 Python 2 與 Python 3 中差異很大；在較新的 Python 3 版本(3.4+)中，自定義的加載器需要實現find_spec方法，而早期的版本用的則是find_module。

以上代碼是一個自定義的類庫加載器 AutoInstall，可以實現自動導入三方庫的目的。需要說明一下，這種方法會“劫持”所有新導入的庫，破壞原有的導入方式，因此也可能出現一些奇奇怪怪的問題，敬請留意。

sys.meta_path 屬于 Python 探針的一種運用。探針，即import hook，是 Python 幾乎不受人關注的機制，但它可以做很多事，例如加載網絡上的庫、在導入模塊時對模塊進行修改、自動安裝缺失庫、上傳審計信息、延遲加載等等。

限于篇幅，我們不再詳細展開了。最后小結一下：

可以用 try…except 方式，實現簡單的三方庫導入或者替換

已知全部缺失的依賴庫時(如 requirements.txt)，可以手動安裝

利用 sys.meta_path，可以自動導入任意的缺失庫

參考資料：

https://github.com/liuchang0812/slides/tree/master/pycon2015cn

http://blog.konghy.cn/2016/10/25/python-import-hook

https://docs.python.org/3/library/sys.html#sys.meta_path