Python | 安裝與測試 OpenCV

📚 前言

在完成 Python 環境與 PyCharm 設定後，我們就可以開始安裝 OpenCV。
這篇文章將帶你完成安裝流程，並透過簡單程式測試是否成功。

🛠️ Step 1. 新建專案

1. 打開 PyCharm → 選擇 New Project。
   
2. 專案名稱建議取：opencv-tutorial。

   1	D:\PythonWorkspace\opencv-tutorial

3. 在 Interpreter 區域選擇你要的 Python 解譯器（Project venv / Base Conda / Custom environment）。
   
4. 建立完成後，PyCharm 會自動幫你設定好專案環境。
   

👉 這個專案將成為後續所有 OpenCV 範例的工作空間。

🛠️ Step 2. 安裝 OpenCV

在 PyCharm 的 Terminal 輸入以下指令：

1

pip install opencv-python

若需要進階模組（例如 SIFT、aruco 標記偵測），可安裝：

1

pip install opencv-contrib-python

使用 conda（可選）

如果你使用 Anaconda/Miniconda，可以輸入：

1

conda install -c conda-forge opencv

👉 本系列以 pip + venv 為主，conda 僅作補充

🛠️ Step 3. 測試安裝

複製一張圖片進去專案內：(此處使用部落格大頭照當作範例 檔名為：test.png)

建立一個 test_opencv.py，輸入以下程式碼：

1
2
3
4
5
6
7
8
9
10

import cv2

# 顯示版本
print("OpenCV version:", cv2.__version__)

# 測試讀取與顯示圖片
img = cv2.imread("test.png")   # 輸入剛剛圖片路徑與檔案名稱 test.png
cv2.imshow("Test Image", img)
cv2.waitKey(0)
cv2.destroyAllWindows()

執行後：

• Console 會顯示 OpenCV 版本號。
• 視窗會彈出並顯示圖片，按任意鍵即可關閉。
  👉 如果能正確顯示圖片，就代表安裝成功

圖：成功顯示圖片，安裝測試完成

⚠️ 常見問題

• ModuleNotFoundError: No module named ‘cv2’
  → 確認是否在正確的 venv 環境中安裝。
• DLL load failed
  → 嘗試更新 pip 與套件：
  pip install –upgrade pip setuptools wheel

結語 🎯

這篇導讀文章將作為系列的入口，後續每篇文章都會深入介紹其中一個主題。
只要跟著這份目錄一步步學習，就能從零開始掌握 OpenCV，並應用在電腦視覺專案中。

註：以上參考了
OpenCV Tutorials
OpenCV-Python Tutorials