HOWTO · Python

如何在 Python 的 Conda 環境中安裝 OpenCV

使用 pip、conda 或 Anaconda Navigator 在 Conda 環境中為 Python 安裝 OpenCV,然後確認該環境能匯入 cv2。

本頁內容

若要在 Conda 環境中為 Python 安裝 OpenCV,可以使用 pip、conda 或 Anaconda Navigator。透過 pip 安裝的套件名稱是 opencv-python,而 Python 使用 cv2 作為匯入名稱。無論選擇哪種方式,都請將套件安裝到預計執行程式碼的環境,並在該環境中確認匯入是否成功。

在 Conda 環境中使用 pip 安裝 OpenCV

安裝前先啟用要使用的 Conda 環境,讓 pip 和 Python 指向同一個環境。在已啟用該環境的終端機中執行 python -m pip install opencv-python。使用 python -m pip 會透過該環境的 Python 直譯器呼叫 pip。此套件由 PyPI 上的 opencv-python 專案提供。

如果不想啟用環境,也可以改用該環境的 Python 執行檔,並加上 -m pip。請避免使用無關的系統 pip,否則套件可能會安裝到其他直譯器所使用的環境。

使用 conda 安裝 OpenCV

啟用目標環境後,執行 conda install opencv,即可安裝 Conda 套件。Conda 會為該環境解析套件及其相依項目。套件是否可用可能因平台和通道而異。如果預設通道沒有提供此套件,可以改用由社群維護的 conda-forge 通道,執行 conda install -c conda-forge opencv(套件頁面)。這是另一個套件來源,但不保證其中的版本較新。

使用 Anaconda Navigator 安裝 OpenCV

在 Anaconda Navigator 中,選取要執行 Python 專案的環境。開啟套件檢視;如果套件清單有套用篩選,請選擇 All,然後搜尋 opencv。選取套件並按下 Apply,即可檢視並安裝變更。Navigator 會將套件安裝到目前選取的環境;若選取其他環境,可匯入 cv2 的 Python 直譯器也會不同。

確認 cv2 是否已安裝

請使用目標 Conda 環境中的 Python 直譯器執行這項檢查。若能匯入模組,程式會顯示其版本;若此直譯器所在的環境沒有該套件,則會顯示明確的提示訊息。

import importlib.util

if importlib.util.find_spec("cv2") is None:
    print("cv2 is not installed in this Python environment.")
else:
    import cv2
    print(cv2.__version__)
cv2 is not installed in this Python environment.

提供的執行紀錄顯示,這項檢查執行後輸出了 cv2 is not installed in this Python environment.;這段輸出文字維持英文,並未翻譯。若環境中已安裝 OpenCV,版本行會顯示已安裝的 OpenCV 版本。如果出現未安裝套件的提示,請確認目前選取或啟用的環境,是否與安裝套件時使用的環境相同。成功匯入只能確認套件基本上可用,無法測試 OpenCV 的所有功能,也不會替電腦視覺專案完成設定。

選擇安裝方式

如果想透過目標環境的直譯器安裝 Python 套件,可以使用 pip。如果希望由 Conda 管理套件及其相依項目,可以使用 conda;有需要時也可改用 conda-forge 通道。如果偏好以圖形介面管理套件,則可選擇 Anaconda Navigator。適合的方式取決於你的環境,以及管理套件的習慣。