Python 用 opencv-python のインストール（Windows 上）

前準備

Python 3.12 のインストール

以下のいずれかの方法で Python 3.12 をインストールする。

方法1：winget によるインストール

Python がインストール済みの場合、この手順は不要である。管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install -e --id Python.Python.3.12 --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 AssociateFiles=1 InstallLauncherAllUsers=1"

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

方法2：インストーラーによるインストール

1. Python 公式サイト（https://www.python.org/downloads/）にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
2. ダウンロードしたインストーラーを実行する。
3. 初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
4. 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号（例：Python 3.12.x）が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

Python 用 opencv-python のインストール

1. 以下の手順を管理者権限のコマンドプロンプトで実行する （手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。
2. 使用する Python のバージョンの確認

   python --version
   

   
3. 旧バージョンのものを削除，Python 用 opencv-python のインストール

   python -m pip uninstall -y opencv-python
   python -m pip uninstall -y opencv-python-headless
   python -m pip uninstall -y opencv-contrib-python
   python -m pip install -U opencv-python opencv-contrib-python
   

   
4. 確認のためバージョン確認

   * バージョン番号が「4.1.2」のように表示されれば OK．下の図とは違うバージョンが表示されることがある

   python -c "import cv2; print( cv2.__version__ )"
   

   

確認のため Python プログラムを動かしてみる

画像ファイル fruits.jpg のダウンロード

画像ファイル fruits.jpg のダウンロードは， 次のコマンドを実行する．（Ubuntu での curl のインストールは「sudo apt -y install curl」）

cd /d c:%HOMEPATH%
curl -L https://github.com/opencv/opencv/blob/master/samples/data/fruits.jpg?raw=true -o fruits.jpg

画像表示プログラムの実行

import cv2
bgr = cv2.imread('c:/opencv/sources/samples/data/fruits.jpg')
cv2.imshow("", bgr)
cv2.waitKey(0)
cv2.destroyAllWindows()

画像が表示されるので確認． このあと，ウインドウの右上の「x」をクリックしない．画面の中をクリックしてから，何かのキーを押して閉じる

【まとめ】 Python環境確認後，pipでopencv-pythonをインストール，サンプルプログラムで動作確認．