Python OpenCV 설치부터 실습까지 한 번에 끝내기

 

반응형

Python과 OpenCV를 Windows 10 환경에 설치하고,
웹캠 영상까지 출력하는 실습을 한 번에 끝낼 수 있도록 전체 과정을 정리했습니다.
설치 오류 없이 처음부터 끝까지 따라 할 수 있도록 단계별로 안내합니다.

 

 

---

영상이나 이미지를 처리하는 프로젝트를 진행하다 보면, 가장 먼저 준비해야 할 것이 바로 Python과 OpenCV입니다.
저 역시 영상 데이터를 다루는 과정에서 이 조합을 기본 환경으로 사용하고 있고,
처음 환경 세팅할 때 막히는 부분이 많아, 정리해두면 좋겠다고 생각해 이 글을 작성하게 되었습니다.

아래 순서대로 따라 하시면 설치부터 테스트 코드 실행까지 한 번에 완료하실 수 있습니다.

---

1. Python 설치

공식 웹사이트에서 Python 설치 파일을 다운로드합니다.
https://www.python.org/downloads/

Download Python

 

버전은 3.10 이상을 추천하며, 설치 과정 중 반드시 아래 항목을 체크해 주세요.

☑ Add Python to PATH

이 항목을 체크하지 않으면 cmd에서 python 명령어가 작동하지 않을 수 있습니다.

설치가 완료되면 명령 프롬프트(cmd)를 열고 다음 명령어를 입력해 설치 확인을 합니다.

python --version

 

 

 

 

---

2. pip 확인 및 업데이트

pip는 Python 패키지를 설치할 때 사용하는 도구입니다. 다음 명령어로 pip 버전을 확인해보세요.

pip --version

정상 출력이 되지 않거나 pip가 없다고 나오면 다음 명령어로 수동 업데이트를 진행합니다.

python -m pip install --upgrade pip

---

3. OpenCV 설치

OpenCV는 이미지/영상 처리를 위한 Python 라이브러리입니다.
아래 명령어로 설치할 수 있습니다.

pip install opencv-python

GUI 환경이 필요 없는 서버에서는 다음 명령어를 사용하세요.

pip install opencv-python-headless

---

4. 설치 확인

Python을 실행해 아래 코드를 입력해 설치가 잘 되었는지 확인합니다.

import cv2
print(cv2.__version__)

OpenCV 버전이 정상적으로 출력되면 설치 완료입니다.

 

 

---

5. 웹캠 영상 출력 테스트

카메라가 연결되어 있다면, 아래 코드를 실행해 실시간 영상을 확인할 수 있습니다.

import cv2

cap = cv2.VideoCapture(0)

while cap.isOpened():
    ret, frame = cap.read()
    if not ret:
        break
    cv2.imshow('Camera Preview', frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

영상 창이 뜨고 ‘q’를 누르면 창이 닫히면 성공입니다.

---

코드퀸 팁

• 외장 카메라 사용 시 VideoCapture(1) 또는 2로 번호를 바꿔서 테스트하세요.
• 영상 저장까지 하고 싶다면 cv2.VideoWriter()도 함께 학습해보세요.
• GUI 없는 환경에서는 imshow() 대신 이미지를 저장해 확인하는 방식도 추천드립니다.

---

이 가이드를 통해 Python과 OpenCV 환경이 제대로 세팅되셨다면,
이제 필터 적용, 윤곽선 추출, 객체 탐지 등의 실습으로 확장해보세요.

다음 글에서는 OpenCV를 활용한 영상 필터링이나 프레임 저장 기능도 다뤄보겠습니다.
원하시는 내용이 있다면 댓글로 남겨주세요!