第一次遇到 ModuleNotFoundError: No module named sqlalchemy 時(shí)大部分人的第一反應(yīng)都是那還不簡(jiǎn)單pip install sqlalchemy 唄。結(jié)果往往是命令行里刷了幾行 Successfully installed回頭再跑腳本報(bào)錯(cuò)紋絲不動(dòng)。這個(gè)場(chǎng)景太常見了常見到我?guī)缀趺恐芏寄茉诩夹g(shù)群里看到一遍。要真正解決這個(gè)問題必須先分清楚這個(gè)報(bào)錯(cuò)到底發(fā)生在哪個(gè)環(huán)節(jié)。ModuleNotFoundError 本質(zhì)上是在 import 階段觸發(fā)的錯(cuò)誤也就是說Python 解釋器在運(yùn)行你的腳本時(shí)按照 sys.path 里的路徑去尋找名為 sqlalchemy 的包找了一圈沒找到于是拋出了這個(gè)異常。它說明的是當(dāng)前正在運(yùn)行代碼的這個(gè)解釋器看不到你要的模塊不代表你的電腦上完全沒有這個(gè)包更不代表 pip 安裝失敗了。這篇博文的核心目標(biāo)就是把從看到報(bào)錯(cuò)到徹底跑通之間那幾步最容易踩坑的環(huán)節(jié)講透并且給出可以照著敲的排查命令和修復(fù)步驟不管你是初學(xué)者還是偶爾幫忙看問題的人照著一路做下來基本能自己解決九成以上的 ModuleNotFoundError。sqlalchemy 作為 Python 世界里最常用的 ORM 和 SQL 工具包之一幾乎出現(xiàn)在所有涉及數(shù)據(jù)庫操作的項(xiàng)目里——FastAPI 的教程用、爬蟲的數(shù)據(jù)存儲(chǔ)用、數(shù)據(jù)分析腳本也會(huì)用所以這個(gè)報(bào)錯(cuò)的出鏡率極高值得單獨(dú)拿出來系統(tǒng)講一次。1. 這個(gè)報(bào)錯(cuò)的兩層含義安裝環(huán)節(jié)和導(dǎo)入環(huán)節(jié)各自在說什么1.1 全流程拆解從 pip install 到 import 之間發(fā)生了什么很多人把安裝和導(dǎo)入當(dāng)成同一件事其實(shí)它們是兩件完全不同的事。安裝是把包下載并解壓到某個(gè)倉庫目錄導(dǎo)入是讓解釋器從某個(gè)視圖目錄里去查找。如果你裝的倉庫和解釋器查找的視圖不是同一個(gè)目錄那裝得再多也白搭。我習(xí)慣把它類比成快遞送到小區(qū) A 棟你去 B 棟取件快遞柜翻個(gè)底朝天也找不到但快遞確實(shí)送到了——這就是環(huán)境不一致。具體到技術(shù)層面pip install 做了什么它會(huì)從 PyPI 下載包然后根據(jù) pip 當(dāng)前綁定的 Python 環(huán)境把包的文件解壓到那個(gè)環(huán)境對(duì)應(yīng)的 site-packages 目錄下。在 Windows 上這個(gè)目錄通常是 Python 安裝目錄下的 Lib\site-packages在 Linux/Mac 上則是 lib/python3.x/site-packages。而 import sqlalchemy 這條語句做了什么解釋器會(huì)按照 sys.path 中記錄的目錄順序逐一查找是否存在名為 sqlalchemy 的目錄或模塊文件。sys.path 里面最重要的幾個(gè)條目包括當(dāng)前腳本所在目錄、標(biāo)準(zhǔn)庫目錄、以及當(dāng)前解釋器的 site-packages 目錄。所以這個(gè)報(bào)錯(cuò)實(shí)際上是兩個(gè)環(huán)節(jié)之間出現(xiàn)了錯(cuò)位。你要是不搞清楚引起錯(cuò)位的具體原因盲目 pip install 等于閉著眼睛修機(jī)器運(yùn)氣好一次搞定運(yùn)氣差折騰半天還是老樣子。1.2 最典型的誤區(qū)pip install 成功不等于 import 成功在所有 ModuleNotFoundError 相關(guān)的問題里最典型的誤區(qū)就是看到 Successfully installed 就當(dāng)萬事大吉。實(shí)際上pip 輸出的成功消息只代表下載并解壓順利它完全沒有半點(diǎn)當(dāng)前解釋器能夠?qū)胨囊馑肌Ｎ以趲腿伺挪閱栴}時(shí)總結(jié)過一種高頻現(xiàn)象對(duì)方在終端里執(zhí)行 pip install sqlalchemy輸出 Successfully installed sqlalchemy-2.0.25然后緊接著在同一個(gè)終端里執(zhí)行 python再輸入 import sqlalchemy卻照樣報(bào) No module named。出現(xiàn)這種現(xiàn)象十有八九是下面這幾種情況里的某一種機(jī)器上同時(shí)存在 Python 3.9 和 Python 3.11pip 是 3.9 的而 python 命令調(diào)用的卻是 3.11 的解釋器。終端里的 pip 是系統(tǒng)環(huán)境的 pip代碼實(shí)際運(yùn)行在某個(gè) venv 虛擬環(huán)境里。終端里的 python 和 IDE 里配置的解釋器不是同一個(gè)。也就是說pip install 成功只能證明某個(gè)環(huán)境里有了這個(gè)包不能證明你正在用的環(huán)境里有這個(gè)包。這一條一旦想明白了后面所有的排查步驟就都有了方向。2. 先別急著重裝環(huán)境隔離才是罪魁禍?zhǔn)?.1 誰在運(yùn)行你的項(xiàng)目venv、conda、全局 Python大多數(shù)開發(fā)機(jī)里會(huì)同時(shí)存在好幾套 Python 環(huán)境這套環(huán)境隔離機(jī)制是環(huán)境類報(bào)錯(cuò)最根本的來源。一個(gè)日常開發(fā)機(jī)上可能有系統(tǒng)自帶的 PythonWindows 上可能是官網(wǎng)安裝包裝的Linux 上可能是 /usr/bin/python3可能有 PyCharm 或 VS Code 幫你創(chuàng)建的虛擬環(huán)境 venv可能還裝過一個(gè) Anaconda 或 Miniconda。每一套環(huán)境都有自己獨(dú)立的 site-packages 目錄也就是說每套環(huán)境里安裝的第三方包彼此不互通。很多人以為環(huán)境是進(jìn)階才需要掌握的概念其實(shí)它從你第一次安裝 Python 起就存在了。就算你只裝過一個(gè) Python系統(tǒng)里也可能同時(shí)存在系統(tǒng)級(jí) site-packages 和用戶級(jí) site-packages。你在命令行里用 pip install 裝包時(shí)有些系統(tǒng)會(huì)默認(rèn)裝進(jìn)用戶級(jí)目錄但有些 IDE 項(xiàng)目解釋器讀的是系統(tǒng)級(jí)目錄兩邊根本對(duì)不上。還有一個(gè)高頻場(chǎng)景你明明在外部終端用全局 pip 裝好了 sqlalchemy但項(xiàng)目是在 PyCharm 里跑的。PyCharm 創(chuàng)建項(xiàng)目的時(shí)候經(jīng)常默認(rèn)給項(xiàng)目配一個(gè) venv而 IDE 里運(yùn)行腳本用的是 venv 里的解釋器它只能看到 venv 自己 site-packages 里的包。外部終端里裝得再多在 PyCharm 里照樣報(bào)找不到。這種情況幾乎占據(jù)了此類報(bào)錯(cuò)的一半以上。2.2 pip 和 python 不對(duì)應(yīng)的三個(gè)常見來源你可能會(huì)覺得我明明用同一個(gè)命令行裝的怎么會(huì)不對(duì)應(yīng)實(shí)際上在同一個(gè)命令行里也可以出現(xiàn)不對(duì)應(yīng)。常見來源有三個(gè)第一個(gè)來源是系統(tǒng)里存在多個(gè) Python 版本。比如 Python 3.9 和 Python 3.11 都裝了pip 命令可能綁定了 3.9 的 site-packages而 python 命令搜索到的卻是 3.11 的解釋器。它們?cè)?PATH 里的排名不一樣排在前面的先被調(diào)用。第二個(gè)來源是 Windows 上的 py 啟動(dòng)器。裝多個(gè) Python 版本時(shí)py 命令可以顯式指定版本比如 py -3.9而 pip 這個(gè)命令本身可能對(duì)應(yīng)另一個(gè)版本。兩者混用時(shí)最容易出現(xiàn)安裝與導(dǎo)入錯(cuò)配。第三個(gè)來源是 conda 的 base 環(huán)境。安裝 Anaconda 后安裝包會(huì)修改 PATH把 conda 的 base 環(huán)境目錄排在前面。你以為自己在用系統(tǒng) Python其實(shí)命令行里的 python 是 conda 管理的那套 Python。conda 環(huán)境裝包和系統(tǒng) Python 的 import 就完全看不到。2.3 系統(tǒng)包管理的保護(hù)機(jī)制externally-managed-environment最近兩年還冒出一個(gè)非常新的坑Linux 發(fā)行版開始對(duì) pip 的全局安裝出手限制。較新的 Debian、Ubuntu 系統(tǒng)自帶 Python 是由系統(tǒng)包管理器管理的直接 pip install 到系統(tǒng)環(huán)境時(shí)會(huì)收到一個(gè) externall-managed-environment 的報(bào)錯(cuò)意思是你不能用 pip 往系統(tǒng) Python 里隨便裝東西應(yīng)該優(yōu)先使用 venv 或者系統(tǒng)自己的 apt。這個(gè)限制的本意是防止 pip 裝的東西和系統(tǒng)的包管理器沖突結(jié)果很多人在中招后又多了一個(gè)為什么我明明執(zhí)行了 pip install 卻裝不上的疑問。實(shí)際上它在提醒你這個(gè)系統(tǒng)環(huán)境不該用 pip 來管包。遇到這種情況最合理的做法就是給項(xiàng)目建一個(gè) venv在虛擬環(huán)境里安裝。3. 從報(bào)錯(cuò)到定位一條完整的排查鏈路3.1 第一步確認(rèn)當(dāng)前解釋器是誰面對(duì) ModuleNotFoundError我從來不會(huì)直接去 pip install而是先執(zhí)行一條命令python -c import sys; print(sys.executable)這條命令會(huì)打印出當(dāng)前終端里 python 這個(gè)命令對(duì)應(yīng)的解釋器絕對(duì)路徑。在 Windows 上通常是C:\Users\你的用戶名\AppData\Local\Programs\Python\Python311\python.exe之類的路徑在 Linux/Mac 上則是/usr/bin/python3或某個(gè)虛擬環(huán)境的bin/python。這一步的目的是確定報(bào)錯(cuò)腳本實(shí)際用的解釋器到底是哪一套。如果你的腳本是在 IDE 里運(yùn)行的還要去 IDE 的解釋器設(shè)置里確認(rèn)它選中的路徑。PyCharm 在設(shè)置 - Project - Python Interpreter 里能看到VS Code 在右下角選擇解釋器的地方也能看到。命令行里的 python 路徑往往不等于 IDE 里的 python 路徑這一點(diǎn)要格外留神。3.2 第二步確認(rèn)包裝到了哪里執(zhí)行pip show sqlalchemy如果命令輸出里有 Name、Version、Location 這些信息說明 sqlalchemy 已經(jīng)安裝過了而且 Location 會(huì)明確告訴你它被裝在哪個(gè) site-packages 目錄里。關(guān)鍵來了把這個(gè) Location 和第一步里解釋器的路徑做個(gè)對(duì)比。舉個(gè)例子Location 顯示是C:\Users\...\Python311\Lib\site-packages但解釋器是D:\project\venv\Scripts\python.exe那就完全對(duì)不上。這基本上就是報(bào)錯(cuò)的直接原因包在 A 環(huán)境里代碼在 B 環(huán)境里跑B 環(huán)境當(dāng)然看不到。如果 pip show 完全沒有輸出任何信息說明當(dāng)前終端 pip 關(guān)聯(lián)的環(huán)境里根本沒有 sqlalchemy。這時(shí)候要看 pip 關(guān)聯(lián)的解釋器是誰執(zhí)行pip -V它會(huì)打印類似pip 23.3.1 from /path/to/site-packages/pip (python 3.11)的內(nèi)容括號(hào)里的 python 3.11 就是這條 pip 綁定的解釋器版本。你很快就能判斷出這個(gè) pip 對(duì)應(yīng)的 Python 是不是你在用的那個(gè)。3.3 第三步直接測(cè)試導(dǎo)入并比對(duì)通道接著做兩個(gè)測(cè)試。第一個(gè)是python -c import sqlalchemy; print(sqlalchemy.__version__)看報(bào)錯(cuò)是否能在命令行里復(fù)現(xiàn)。如果命令行里能正常導(dǎo)入但 IDE 里報(bào)錯(cuò)那問題一定在 IDE 選擇的解釋器上。第二個(gè)是python -m pip --version這條命令的意思是用當(dāng)前解釋器運(yùn)行 pip 模塊它打印出來的 pip 路徑才真正對(duì)應(yīng)當(dāng)前 python 使用的 pip。這里我想特別強(qiáng)調(diào) python -m pip 這個(gè)用法很多環(huán)境類問題歸根結(jié)底是 pip 這個(gè)命令綁定的解釋器和 python 不一致。而 python -m pip 是從當(dāng)前 python 解釋器內(nèi)部去調(diào)用 pip所以它安裝的包一定會(huì)進(jìn)當(dāng)前解釋器的 site-packages。這個(gè)命令應(yīng)該成為你日常裝包的默認(rèn)姿勢(shì)。在這個(gè)環(huán)節(jié)還可以順手看一下當(dāng)前解釋器的 sys.pathpython -c import sys; print(\n.join(sys.path))如果其中有一個(gè) site-packages 路徑看起來不對(duì)勁或者是你期望的那個(gè)環(huán)境沒出現(xiàn)就說明 PATH 順序出了問題。sys.path 里的目錄就是解釋器在 import 時(shí)會(huì)去查找的所有地方。3.4 第四步多 Python 并存與 PATH 順序排查如果上面幾步發(fā)現(xiàn)環(huán)境確實(shí)對(duì)不上還得去查 PATH。在 Windows 的環(huán)境變量設(shè)置里或者在 Linux/Mac 的 shell 配置文件.bashrc、.zshrc里你會(huì)發(fā)現(xiàn)往往有多個(gè) Python 相關(guān)的路徑。終端執(zhí)行命令時(shí)系統(tǒng)會(huì)按 PATH 的順序從前到后找命令誰排在前面誰就先被調(diào)用。我在排查多環(huán)境問題時(shí)常用的手段是分別執(zhí)行which python which pipWindows 上對(duì)應(yīng)的是where python和where pip?？磧蛇叺穆窂绞欠裰赶蛲粋€(gè)環(huán)境。如果 python 在/usr/local/bin/python3而 pip 在/usr/bin/pip那基本可以斷定安裝和導(dǎo)入各走各的了。解決方式也很簡(jiǎn)單統(tǒng)一用python -m pip來替代裸 pip不依賴哪條 pip 排在前面。4. 按場(chǎng)景分治的修復(fù)方案與驗(yàn)證方法4.1 方案一在虛擬環(huán)境內(nèi)重新安裝最推薦的做法永遠(yuǎn)是為項(xiàng)目創(chuàng)建獨(dú)立的虛擬環(huán)境。如果你當(dāng)前項(xiàng)目還沒有 venv可以在項(xiàng)目根目錄執(zhí)行python -m venv venv然后激活# Windows venv\Scripts\activate # Linux / Mac source venv/bin/activate激活后命令行提示符前面會(huì)出現(xiàn)(venv)字樣這時(shí)候的 python 和 pip 都指向這個(gè)虛擬環(huán)境。再用下面命令完成安裝python -m pip install sqlalchemy注意一個(gè)細(xì)節(jié)不要因?yàn)榧敝b包就先不激活環(huán)境直接裝。很多人在這里偷懶結(jié)果裝回了全局環(huán)境。裝完之后再用python -c import sys; print(sys.executable)確認(rèn)解釋器路徑已經(jīng)指向 venv 里然后運(yùn)行python -c import sqlalchemy; print(sqlalchemy.__version__)驗(yàn)證導(dǎo)入。最后回到 IDE把項(xiàng)目解釋器手動(dòng)切到這個(gè) venv 路徑重新運(yùn)行腳本就正常了。4.2 方案二conda 環(huán)境下恢復(fù)包管理一致性如果用的是 conda情況會(huì)稍有不同。conda 有一套自己管理環(huán)境的邏輯激活某個(gè)環(huán)境后PATH 會(huì)優(yōu)先指向 envs 下的目錄。在 conda 環(huán)境里安裝 sqlalchemy 有兩種方式一是直接執(zhí)行conda install sqlalchemy二是先確認(rèn)conda activate的到底是哪個(gè)環(huán)境再用python -m pip install sqlalchemy。這里有個(gè)小坑即使你激活了 conda 環(huán)境再手動(dòng)執(zhí)行/usr/bin/python3之類的絕對(duì)路徑仍然會(huì)繞過 conda 環(huán)境。所以排查時(shí)務(wù)必用which python確認(rèn)當(dāng)前生效的路徑。如果 conda 里裝過的包在 IDE 里還是報(bào) ModuleNotFoundError基本可以斷定 IDE 用的是 conda base 之外的另一個(gè)解釋器去 IDE 設(shè)置里把它切到環(huán)境路徑即可。conda 環(huán)境下還有個(gè)額外的選擇是用conda install sqlalchemy它會(huì)把依賴一起管理好省心不少但前提是你得先確認(rèn)當(dāng)前 terminal 已經(jīng)激活了正確的 conda 環(huán)境。4.3 方案三處理系統(tǒng)環(huán)境與權(quán)限問題在 Linux 系統(tǒng)上如果你是直接對(duì)著系統(tǒng) Python 干活最穩(wěn)妥的方式是先確認(rèn)是不是受了 externally-managed-environment 的限制。如果系統(tǒng)明確提示不能用 pip 裝全局包就不要硬裝。老老實(shí)實(shí)建 venv 是成本最低的路徑。要是公司服務(wù)器或容器環(huán)境里確實(shí)只能裝到系統(tǒng)環(huán)境這種場(chǎng)景比較少見而且需要謹(jǐn)慎處理因?yàn)槟呛苋菀子绊懴到y(tǒng)里其他依賴包的運(yùn)行。Mac 上的情況我多說一句macOS 自帶的 Python 通常由系統(tǒng)管理直接用 pip 往里面裝東西權(quán)限、路徑、兼容性都可能出問題。平時(shí)我更建議用 homebrew 裝一個(gè)獨(dú)立的 Python或者直接裝官方安裝包再配合 venv 使用。沒必要在系統(tǒng)自帶的 Python 上硬折騰。4.4 版本兼容性Python 版本與 SQLAlchemy 2.x 的限制有時(shí)候問題不在環(huán)境而在版本。SQLAlchemy 2.0 是一個(gè)分水嶺它在 API 和 ORM 寫法上有比較大的變化而且對(duì) Python 版本有硬性要求。SQLAlchemy 2.0 要求 Python 3.7 及以上如果你的解釋器是 Python 3.6 或者更老pip 會(huì)自動(dòng)挑選一個(gè)老版本 SQLAlchemy 裝上或者干脆找不到適配的包版本。老版本 SQLAlchemy 跑新代碼會(huì)在 import 階段或運(yùn)行階段出現(xiàn)各種離奇報(bào)錯(cuò)。所以在修復(fù)前順手執(zhí)行一句python --version看下解釋器版本。如果 python 是 3.7 以下要處理的不只是包而是解釋器本身是否該升級(jí)。即便解釋器版本達(dá)標(biāo)了另一個(gè)潛在障礙是依賴包在某些平臺(tái)上SQLAlchemy 會(huì)拉取 greenlet 這個(gè)底層依賴greenlet 在部分環(huán)境里需要源碼編譯。編譯失敗的時(shí)候pip 會(huì)整段報(bào)錯(cuò)或者留下半安裝狀態(tài)導(dǎo)致 import 還是失敗。遇到這種情況最簡(jiǎn)單的做法是顯式指定二進(jìn)制版本安裝python -m pip install --only-binary :all: sqlalchemy或者直接從官方源安裝對(duì)應(yīng)系統(tǒng)的 wheel 包。實(shí)測(cè)下來這個(gè)方式能繞開大多數(shù)編譯問題。4.5 修復(fù)后如何驗(yàn)證裝完并不是終點(diǎn)驗(yàn)證才是。修好之后建議按這個(gè)順序做一套完整驗(yàn)證python -m pip show sqlalchemy確認(rèn)包出現(xiàn)在你期望的環(huán)境里。然后python -c import sqlalchemy; print(sqlalchemy.__version__)確認(rèn)當(dāng)前解釋器能導(dǎo)入。第三步是回到原始報(bào)錯(cuò)的腳本再次運(yùn)行原命令。如果腳本還是報(bào)這個(gè)錯(cuò)回頭檢查 IDE 的解釋器設(shè)置看看是否切到了同一個(gè) Python。這種方式能快速區(qū)分環(huán)境沒修好和IDE 配置沒改兩種情況。我還見過一種罕見但特別坑的情況項(xiàng)目里已經(jīng)裝了 sqlalchemy但目錄里存在一個(gè)名為 sqlalchemy.py 的自定義文件把真正的包覆蓋了。這種屬于命名沖突。因?yàn)?import 加載包時(shí)會(huì)優(yōu)先加載當(dāng)前項(xiàng)目目錄下的同名文件。檢查方法很簡(jiǎn)單在項(xiàng)目目錄里執(zhí)行python -c import sqlalchemy; print(sqlalchemy.__file__)如果打印出來的路徑指向你的項(xiàng)目目錄而不是 site-packages說明命名沖突了把那個(gè)文件改名即可。5. 同類報(bào)錯(cuò)舉一反三numpy、opencv、mss、pkg_resources 等高頻教訓(xùn)5.1 包名和導(dǎo)入名不一致opencv-python 與 cv2處理完 sqlalchemy 的坑我想多說幾句類似報(bào)錯(cuò)的通用解法因?yàn)?ModuleNotFoundError 在 Python 世界里出現(xiàn)的場(chǎng)景實(shí)在太多了。最常見的變體是安裝名和導(dǎo)入名不一致。比如視覺方向常用的 opencv-pythonpip install opencv-python裝完之后import 的時(shí)候卻是import cv2。很多人第一次碰到時(shí)根本想不到 cv2 就是 opencv 的導(dǎo)入別名于是在網(wǎng)上翻半天才發(fā)現(xiàn)真相。同理Pillow 的導(dǎo)入名是 PILbeautifulsoup4 的導(dǎo)入名是 bs4。這種安裝名與導(dǎo)入名的錯(cuò)位是新手最容易栽跟頭的地方也是查這類問題時(shí)必須記住的第一條知識(shí)點(diǎn)。如果你在安裝過程中看到了一系列依賴包被自動(dòng)裝上但運(yùn)行時(shí)提示缺了某一個(gè)十有八九也是導(dǎo)入名或版本兼容問題。比如腳本里 import numpy但你剛才裝的是新版 numpy 而代碼是按舊版語法寫的運(yùn)行時(shí)就會(huì)報(bào)別的錯(cuò)誤如果報(bào)錯(cuò)信息明確寫著 No module named numpy那就還是回到環(huán)境配對(duì)問題用python -m pip install numpy裝進(jìn)當(dāng)前解釋器即可。5.2 隱性依賴缺失pkg_resources 需要 setuptools另外一個(gè)很有意思的報(bào)錯(cuò)是 ModuleNotFoundError: No module named pkg_resources。這個(gè)錯(cuò)誤常見于跑一些老項(xiàng)目或工具腳本時(shí)。pkg_resources 本身是 setuptools 包里提供的一個(gè)模塊并不是一個(gè)獨(dú)立安裝的包。如果你在清理依賴時(shí)把 setuptools 刪掉了或者某個(gè)虛擬環(huán)境里沒裝完整的 setuptoolsimport pkg_resources 就會(huì)直接失敗。解決辦法不是裝 pkg_resources而是執(zhí)行python -m pip install setuptools這一點(diǎn)特別能說明一個(gè)道理遇到 ModuleNotFoundError不要只盯著報(bào)錯(cuò)信息里那個(gè)名字去搜安裝命令先想清楚這個(gè)模塊到底屬于哪個(gè)包。這種隱性依賴在 Python 生態(tài)里非常普遍。很多庫會(huì)把公共能力拆到不同包里比如 pandas 依賴 numpySQLAlchemy 在某些平臺(tái)上依賴 greenletFastAPI 在特定版本里需要 pydantic 的額外組件。項(xiàng)目代碼 import 一個(gè)庫時(shí)找不到不代表它沒裝而是可能它沒有被聲明為依賴或者環(huán)境的依賴關(guān)系被搞亂了。遇到這種情況除了一次一次 pip install還可以用 pipdeptree 這類工具查看當(dāng)前環(huán)境的依賴樹看看誰依賴誰、誰沒裝全。5.3 不同模塊的同一坑mss、waitress這些年我還在各種環(huán)境問題里見過 mss、waitress 這類相對(duì)小眾的庫名。mss 是屏幕截圖庫waitress 是純 Python 的 WSGI 服務(wù)器。它們的共同點(diǎn)是裝的時(shí)候很容易、用的時(shí)候偶爾就找不到。原因不外乎三種裝到了別的地方、當(dāng)前環(huán)境沒激活、或者版本沖突。處理辦法和 sqlalchemy 是一模一樣的套路定位解釋器確認(rèn) site-packages用 python -m pip 重裝驗(yàn)證導(dǎo)入。這也是為什么我一直強(qiáng)調(diào)排查步驟本身比某個(gè)具體的包重要得多。你只要把解釋器路徑 site-packages 是否兼容這三件事理順任何 No module named 報(bào)錯(cuò)都能拆掉九成。5.4 通用排查口訣與防復(fù)發(fā)習(xí)慣最后結(jié)合這些年的排查經(jīng)驗(yàn)我給幾個(gè)非常實(shí)用的防復(fù)發(fā)習(xí)慣。第一所有項(xiàng)目統(tǒng)一用 venv哪怕是寫個(gè)小腳本也值得花三秒鐘把環(huán)境建好。這個(gè)習(xí)慣能幫你避免掉絕大多數(shù)的環(huán)境錯(cuò)配問題。第二把 python -m pip 當(dāng)作默認(rèn)安裝命令不要直接敲裸 pip。裸 pip 對(duì)外界環(huán)境狀態(tài)太敏感python -m pip 則永遠(yuǎn)和當(dāng)前解釋器綁定。第三不確定時(shí)先查環(huán)境而不是先重裝。執(zhí)行python -c import sys; print(sys.executable)這個(gè)動(dòng)作花費(fèi)不到五秒鐘卻能給你節(jié)省十幾分鐘的瞎折騰。第四項(xiàng)目里不要放與包名同名的腳本。sqlalchemy.py、requests.py、utils.py 這類名字一旦放在項(xiàng)目根目錄就可能在 import 時(shí)被優(yōu)先加載產(chǎn)生各種離奇問題。我個(gè)人在實(shí)際操作中還保留著一個(gè)習(xí)慣每次打開新項(xiàng)目時(shí)先在項(xiàng)目根目錄建一套 venv再把依賴寫進(jìn) requirements.txt裝包只用一個(gè)命令python -m pip install -r requirements.txt。這樣即使某天環(huán)境徹底崩潰重建環(huán)境也只是幾分鐘的事再也不會(huì)被 ModuleNotFoundError 這類問題攔在手忙腳亂的路上了。