🎯 Python 3.12에서 venv 생성 시 Pip 오류 해결 방법 (최신 정리)

 

문제 요약

Python 3.12 환경에서 venv(가상환경)를 만들었을 때,
pip, setuptools 버전이 너무 오래된 경우
다음과 같은 오류가 발생할 수 있습니다.

❌ AttributeError: module 'pkgutil' has no attribute 'ImpImporter'

이 문제는 Python 3.12부터 내부 모듈 구조가 변경되어,
기존 pip/setuptools 구버전이 호환되지 않기 때문입니다.

---

주된 에러 상황

• pip 명령어 실행 실패
• setuptools 관련 오류 발생
• venv 안에서 패키지 설치 불가
• PyQt6 등 설치 시도 시 ModuleNotFoundError

---

원인

Python 3.12부터:

• pkgutil.ImpImporter가 삭제됨
• pip / setuptools 구버전이 이를 참조하기 때문에 충돌 발생

---

해결 방법 (100% 작동)

1. 기존 venv 삭제

Remove-Item -Recurse -Force venv

(Windows PowerShell 기준)

1. 새 venv 생성

python -m venv venv

1. venv 활성화

.\venv\Scripts\Activate

1. 최신 pip 강제 설치 (ensurepip 사용)

python -m ensurepip --upgrade

1. pip와 setuptools 업그레이드

python -m pip install --upgrade pip setuptools

1. 필요한 패키지 설치 (예시: PyQt6)

pip install PyQt6

---

주의사항

• 반드시 ensurepip 명령어를 사용해 최신 pip를 강제 설치해야 합니다.
• 기존 고장난 venv는 복구할 수 없으므로 반드시 새로 생성합니다.
• Python 3.12부터는 모든 venv를 새로 생성하는 것이 안전합니다.

---

요약

항목설명

문제	pip, setuptools 구버전이 Python 3.12과 충돌
원인	Python 3.12부터 내부 모듈 구조 변경
해결	venv 삭제 → 새로 생성 → ensurepip로 pip 업그레이드

---

결론

Python 3.12 환경에서는,
venv 생성 후 반드시 최신 pip와 setuptools를 설치해야
pip 관련 오류 없이 패키지를 정상 설치하고 사용할 수 있습니다.

특히 PyQt6, Tensorflow, FastAPI 같은 패키지를 설치할 때
pip 오류가 발생하면 위 방법으로 해결할 수 있습니다.

---

✅ 함께 읽으면 좋은 글

• Python 공식 문서: venv 모듈 설명
• Python 3.12 변경사항 (What's New in Python 3.12)

---

🛠️ 지금 이 방법으로 바로 문제를 해결하세요!

---

(검색 키워드 자동 포함 완료)

• Python 3.12 pip 오류
• venv pip 설치 문제
• pkgutil ImpImporter 에러 해결
• pip 업그레이드 방법
• PyQt6 설치 오류 해결