import報錯No module named "xxx"的問題

如何將指定目錄作為項目根目錄，讓項目根目錄下的包/模塊都可以直接導入？（linux下）
Python導入模塊時，解釋器如何定位模塊：
1.當前目錄
2.內置模塊列表
3.sys.path列表的目錄

由于python沒有定位到模塊目錄時出現的No module named "xxx"問題，大概有兩種解決思路：
1.在sys.path永久加入需要導入的模塊的父目錄；2.每次要導入時在執行的py文件中執行sys.path.append方法將需要導入的模塊的父目錄加入到sys.path

問題和解決示例：
永久將某個目錄加入到sys.path讓這個目錄下的py文件在導包時python的finder可以直接查找到

Desktop/pytest/下兩個各包含一個py文件的文件夾：test/test.py path_test/path_test.py # test.py print("test") # path_test.py from test import test

目標：在目錄path_test下執行python3 path_test.py，應該打印出字符串test（一般情況下未配置.../pytest/作為源目錄時會出現報錯No module named “test” 或者ImportError之類的）

將指定目錄加入到sys.path（永久或者臨時），作為某個項目的源目錄（source root）的方法步驟：

進入pytest/目錄在終端輸入pwd命令獲取到pytest/的絕對路徑：
/home/image/Desktop/pytest

查看和復制python3的sitepackage路徑：

>>python3 >>import site >>site.getsitepackages() ['/usr/local/lib/python3.8/dist-packages', '/usr/lib/python3/dist-packages', '/usr/lib/python3.8/dist-packages']

復制sitepackages所在路徑，根據自己實際要使用的python版本為準，這里我復制的是第一個：
/usr/local/lib/python3.8/dist-packages

進入上面復制的目錄下cd /usr/local/lib/python3.8/dist-packages
創建并編輯一個.pth文件
(sudo) vim /usr/local/lib/python3.8/dist-packages/xxx.pth
xxx是你的文件命名
在xxx.pth文件中加入需要添加的項目根目錄的路徑：

驗證看是否目錄添加到sys.path成功

>>python3 >>import sys >>sys.path ['', '/usr/lib/python38.zip', '/usr/lib/python3.8', '/usr/lib/python3.8/lib-dynload', '/usr/local/lib/python3.8/dist-packages', '/home/image/Desktop', '/home/image/Desktop/pytest', '/usr/lib/python3/dist-packages']

倒數第二個路徑/home/image/Desktop/pytest是剛剛加進去的
在Desktop/pytest/path_test/目錄下執行：

>>>python3 path_test.py

看起來在 應該可以導入然后打印字符串test，但是卻出現了ImportError：

Traceback (most recent call last):File "path_test.py", line 5, in <module>from test import test ImportError: cannot import name 'test' from 'test' (/usr/lib/python3.8/test/__init__.py)

經過一番檢查之后，發現似乎是在找到sys.path的路徑之前，在內置模塊匹配到了另外一個名為test的模塊，然后沒有找到需要的/test/test.py，于是想到了解決方法
修改名稱目錄Desktop/pytest/test/的名稱，例如Desktop/pytest/example/：
mv test/ example/

同時path_test.py中代碼修改為from example import test

然后再運行:

>>>python3 path_test.py test

發現正常運行，打印了字符串test

臨時將指定目錄加入到sys.path讓python finder可以在導包時可以直接查找到的方法
不修改文件夾名稱，單個py文件的一次性解決方法，注意把路徑插入到sys.path列表的第一位而不是append
這個時候直接在代碼里執行sys.path.insert(0, ‘/home/image/Desktop/pytest’)，可以對于本test.py文件奏效

總結

以上是生活随笔為你收集整理的Python导包、模块报错的问题的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。