여러 파이썬 버전 환경에서 Pygame 설치하는 방법과 오류 해결법

@도마2·2025. 12. 23. 23:00

728x90

파이썬으로 코딩을 하다 보면
pygame이나 다른 패키지 설치 과정에서
오류를 겪는 경우가 많습니다.

특히 여러 버전의 파이썬이 설치된 환경에서는
원하는 버전에 설치되지 않거나,
설치는 되었는데 실행이 안되는 문제가 자주 발생합니다.

이 글에서는
1. 여러 파이썬 버전 중 원하는 버전을 선택해 Pygame 설치하는 방법
2. Pygame이 특정 파이썬 버전에서 설치되지 않을때 해결 방법
3. 설치 실패를 줄이기 위한 꿀팁
을 정리합니다.

1. 현재 설치된 파이썬 버전 확인 방법

CMD(명령 프롬프트)를 실행한 후 아래 명령어를 입력합니다.

py -0

출력 예시는 다음과 같습니다.

 -3.12-64
 -3.11-64
 -3.9-64

이는 현재 PC에 설치된 모든 파이썬 버전 목록입니다.
이제 이 중에서 원하는 버전을 골라 Pygame을 설치하면 됩니다.

2. 원하는 파이썬 버전으로 Pygame 설치하는 방법

X 잘못된 방법

pip install pygame

이 방식은 어떤 파이썬 버전에 설치되는지 알 수 없기 때문에 오류의 원인이 됩니다.

O 권장 방법 (정석)

아래와 같이 py -버전 -m pip 형식을 사용합니다.

py -3.11 -m pip install pygame

이 명령어는

Python 3.11 전용 pip 실행
해당 버전에만 pygame 설치를 의미합니다.

3. 설치 후 정상 동작 확인 방법

설치가 끝났다면 아래 명령어로 바로 확인합니다.

py -3.11 -m pygame.examples.aliens

예제 게임이 실행되면 정상 설치된 상태입니다.

또는 파이썬 인터프리터에서 확인할 수도 있습니다.

py -3.11
>>> import pygame
>>> pygame.__version__

에러가 발생하지 않으면 성공입니다.

4. Pygame이 특정 파이썬 버전에서 안 깔릴 때 해결 방법

① 파이썬 최신 버전 문제 (특히 3.12)

현재 기준으로 Python 3.12에서는 pygame 호환 문제가 발생하는 경우가 많습니다.

해결 방법:

Python 3.10 또는 3.11 사용 권장
게임 개발 입문자는 3.11이 가장 안정적입니다.

② pip 자체가 오래된 경우

아래 명령어로 pip를 먼저 업데이트합니다.

py -3.11 -m pip install --upgrade pip

그 후 다시 pygame 설치를 시도합니다.

py -3.11 -m pip install pygame

③ Visual C++ Build Tools 오류 발생 시

에러 메시지에 다음과 같은 문구가 있다면:

error: Microsoft Visual C++ 14.0 or greater is required

해결 방법:

Visual Studio Build Tools 설치
설치 시 “C++ 빌드 도구” 체크 필수

④ 권한 문제 (Windows)

CMD를 관리자 권한으로 실행한 뒤 다시 시도합니다.

py -3.11 -m pip install pygame

5. 여러 파이썬 버전 환경에서의 꿀팁

꿀팁 1. 항상 py -버전 -m pip 패턴 사용

py -3.11 -m pip install 패키지명

이 습관 하나로 설치 오류의 80%를 예방할 수 있습니다.

꿀팁 2. VS Code에서는 파이썬 버전 고정하기

Ctrl + Shift + P
Python: Select Interpreter
원하는 버전 선택

설치된 pygame이 인식되지 않는 문제 대부분 해결됩니다.

꿀팁 3. 게임 개발용 파이썬은 하나만 쓰는 것도 방법

Python 3.11 하나만 남기고
나머지는 제거하면 관리가 훨씬 쉬워집니다.

Pygame 설치 문제의 대부분은 파이썬의 버전 혼동에서 발생합니다.

pip install 대신
py -버전 -m pip install 명령어를
사용하는 습관을 들입니다.

되도록이면 3.10 ~ 3.11 버전을 사용하는 것이 좋습니다.