파이썬 venv 가상환경 오류, pip 충돌·SSL 해결
파이썬으로 엑셀 자동화나 데이터 정리 코드를 하나 따라 해 보려고 pip install 명령을 쳤는데, 기존에 잘 돌아가던 다른 스크립트가 갑자기 깨지거나 “의존성 충돌(Dependency Conflict)” 경고가 뜨는 경우가 있습니다. 특히 회사 PC에서 설치를 시도하면 SSLCertVerificationError라는 알 수 없는 보안 인증서 오류 때문에 아예 다운로드 자체가 막히기도 합니다.
이럴 때 파이썬 전체를 지웠다가 다시 까는 것은 시간 낭비일 뿐 아니라 같은 문제가 또 터집니다. 프로젝트별로 독립된 작업 상자를 만드는 파이썬 venv 가상환경 오류 해결 및 격리 원리와 사내망 SSL 인증서 점검법을 차례대로 정리해 보겠습니다.
pip install을 돌릴 때마다 버전 충돌과 SSL 빨간 글씨가 뜨는 이유
처음 파이썬을 배울 때는 모든 패키지를 윈도우 공용 파이썬 폴더 한 군데(전역 환경)에 몰아넣기 쉽습니다. 문제는 A 프로젝트는 구버전 라이브러리(예: 1.x)를 요구하고, B 프로젝트는 최신 버전(예: 2.x)을 요구할 때 생깁니다. 한 방에 둘을 동시에 둘 수 없으니 새 버전을 까는 순간 옛날 프로젝트가 고장 납니다.
한편 SSL: CERTIFICATE_VERIFY_FAILED 오류는 내 인터넷이 끊겼거나 파이썬 서버가 죽어서가 아니라, 회사 보안 장비(프록시·SSL 감시 장비)가 중간에 회사 자체 보안 인증서를 끼워 넣는데 파이썬 기본 신뢰 저장소가 그 회사 인증서를 아직 모르기 때문에 발생합니다.
파이썬 venv 가상환경 오류와 프로젝트 격리의 원리
가상환경(Virtual Environment, venv)은 요리마다 쓰는 냄비와 도마를 프로젝트 폴더 안에 따로 장만하는 것에 비유할 수 있습니다. 거실 공용 서랍에 양념을 다 섞어 두지 않고, 폴더마다 .venv라는 작은 상자를 만들어 그 프로젝트에 필요한 파이썬 실행 파일과 패키지 버전만 깔끔하게 담아 둡니다.
실제 시스템에서도 venv는 새로운 가상 머신을 띄우는 무거운 작업이 아니라, 단지 폴더 안에 독립된 패키지 저장소(site-packages)와 경로 링크만 하나 분리해 주는 가벼운 격리 구조입니다. 따라서 망가져도 해당 .venv 폴더만 지우고 10초 만에 새로 만들면 되므로 PC 전체 파이썬이 엉킬 걱정이 없습니다. 이것이 파이썬 venv 가상환경 오류 예방법의 출발점입니다.
가상환경 생성·패키지 충돌·사내망 SSL 오류 해결 4단계
앞으로 새 파이썬 자동화 폴더를 만들 때마다 아래 4단계 루틴을 먼저 실행하고 패키지를 설치하시기 바랍니다.
가상환경 격리 및 pip SSL 오류 해결 4단계
- 프로젝트 폴더 안에 독립 가상환경(
.venv) 생성: 터미널에서 작업 폴더로 이동한 뒤python -m venv .venv(또는py -m venv .venv)를 실행합니다. 폴더 안에.venv디렉터리가 생기면 성공입니다. - 가상환경 활성화(Activate) 확인: 윈도우 PowerShell에서는
.\.venv\Scripts\Activate.ps1(CMD에서는.venv\Scripts\activate.bat, macOS/리눅스에서는source .venv/bin/activate)를 실행합니다. 프롬프트 맨 앞에(.venv)가 붙었는지 꼭 확인합니다. (만약 PowerShell 실행 정책 오류가 나면Set-ExecutionPolicy -Scope CurrentUser RemoteSigned를 먼저 적용하세요.) - 패키지 설치 및 버전 충돌 시 가상환경 재생성:
(.venv)가 뜬 상태에서pip install 패키지명을 실행합니다. 만약 기존 전역 환경에서 버전이 꼬였다면 기존 폴더를 건드리지 말고 새.venv에서requirements.txt로 깔끔히 다시 설치합니다. - 사내망 SSL 인증서 오류 해결(
pip-system-certs우선, 임시 우회는 제한적): 회사 방화벽 때문에SSLCertVerificationError가 뜬다면 항상 보안 검사를 완전히 끄기보다 먼저 윈도우 시스템 인증서를 파이썬과 연동하는pip-system-certs를 쓰거나 사내 IT 부서에서 루트 인증서(.crt/.pem) 경로를 받아pip --cert 인증서경로로 지정하는 것이 정석입니다. 일회성 테스트로 꼭 불가피할 때만 공식 PyPI 도메인(pypi.org,files.pythonhosted.org)에 한해--trusted-host옵션을 임시 사용합니다.
전역 설치 vs venv 가상환경 격리 설치 비교 표
전역 환경에 바로 설치할 때와 프로젝트별 venv를 나눌 때의 차이를 정리했습니다.
| 구분 | 전역 환경 직접 pip install |
프로젝트별 venv 가상환경 |
|---|---|---|
| 패키지 버전 충돌 | 프로젝트 A·B가 서로 다른 버전 요구 시 즉시 충돌 | 폴더마다 완전히 분리돼 충돌 없음 |
| 오류 복구 난이도 | 어느 패키지가 꼬였는지 추적·삭제가 까다로움 | .venv 폴더 삭제 후 10초 만에 재생성 가능 |
| 배포·PC 교체 이관 | PC에 깔린 수십 개 불필요 패키지가 다 섞임 | pip freeze > requirements.txt로 목록만 깔끔히 추출 |
핵심 정리
파이썬 venv 가상환경 오류와 패키지 버전 충돌을 막는 가장 확실한 방법은 ‘파이썬 본체에는 아무 패키지도 깔지 말고, 모든 작업 폴더마다 .venv 상자를 따로 만들어 활성화한 뒤 설치하는 것’입니다. 또한 사내망 SSL 인증서 오류가 날 때도 보안을 무작정 끄기보다 윈도우 신뢰 인증서 연동이나 사내 인증서 지정 방식을 우선 적용하시기 바랍니다.
재발 방지 체크리스트
재발 방지 체크리스트
- 새 파이썬 폴더를 열 때마다
python -m venv .venv생성 후 활성화((.venv)) 확인하기 - 터미널 프롬프트 앞에
(.venv)표시가 없는 상태에서 무심코pip install누르지 않기 - 사내망 SSL 오류 시 임시 우회(
--trusted-host) 남용 대신 시스템 인증서·사내.crt인증서 연동 우선 확인하기 - Git으로 코드를 관리할 때는
.gitignore에.venv/를 넣어 거대한 라이브러리 폴더가 올라가지 않게 막기









