Python과 pip이 같은 환경인지 확인하기

Windows에서 py를 사용할 수 있다면 다음을 실행합니다.

py --version
py -m pip --version

py가 없고 python으로 실행하는 환경이라면 같은 명령을 python --version, python -m pip --version으로 확인하세요. 어느 명령도 실행되지 않으면 Python 공식 Windows 안내에서 설치·실행 환경부터 확인합니다.

pip --version 결과에는 pip의 버전과 설치 위치·대상 Python 정보가 나옵니다. 여러 Python을 설치했다면 이 위치가 중요합니다. pip 공식 실행 안내도 Python 인터프리터로 pip을 실행하는 방식을 설명합니다.

새 가상환경 만들기

시험할 새 빈 작업 폴더를 열고 Windows에서는 다음을 실행합니다. 기존 프로젝트의 .venv를 덮어쓰는 예제로 사용하지 마세요.

py -m venv .venv
.\.venv\Scripts\python.exe -m pip --version

이후 예제는 모두 이 폴더의 .venv 안에 있는 Python으로 실행합니다. PowerShell의 활성화 스크립트를 실행하지 않아도 이 경로로 사용할 수 있어, 예제를 위해 실행 정책을 바꿀 필요가 없습니다.

Python을 다른 실행 이름이나 경로로 사용 중이라면 첫 줄에서도 원하는 Python을 지정합니다. 가상환경은 Python 공식 venv 문서와 패키징 가이드에서 설명하는 프로젝트별 분리 방식입니다.

패키지 설치 후 실제로 불러오기

여기서는 콘솔 색상 처리를 돕는 Colorama를 사용합니다. 0.4.6은 결과를 맞춰보기 위한 예제의 고정 버전이며 최신 버전이라는 뜻은 아닙니다.

.\.venv\Scripts\python.exe -m pip install colorama==0.4.6
.\.venv\Scripts\python.exe -c "import colorama; from importlib.metadata import version; print(version('colorama'))"

두 번째 명령의 예제 결과는 다음과 같습니다.

0.4.6

설치 메시지만 보는 대신 실제로 사용할 Python에서 import까지 되는지 확인한 것입니다. 편집기나 노트북에서 계속 모듈이 없다고 나오면, 그 프로그램이 선택한 인터프리터도 이 .venv인지 확인하세요.

최신 배포판을 설치하려면 버전 조건을 빼고 install colorama처럼 쓸 수 있습니다. 예제 결과를 그대로 비교하려면 위 고정 버전을 사용합니다. 프로젝트가 요구하는 버전 조건이 있다면 그 조건을 우선하세요.

설치 목록·위치·의존성 확인하기

하려는 일 이 예제에서 실행할 명령
설치된 패키지 목록 .\.venv\Scripts\python.exe -m pip list
패키지의 버전·설치 위치 .\.venv\Scripts\python.exe -m pip show colorama
설치된 의존성 관계 확인 .\.venv\Scripts\python.exe -m pip check

show의 Location이 현재 .venv 아래인지 확인하면 다른 환경에 설치한 상황을 찾는 데 도움이 됩니다. check는 설치된 의존성 요구가 맞는지 확인하는 명령이며, 모든 코드의 동작까지 시험하는 명령은 아닙니다.

패키지를 갱신할 때는 같은 환경에서 -m pip install --upgrade 패키지명을 사용합니다. 실제 이름으로 바꿔 실행하고, 작업 중인 프로젝트의 버전 조건과 호환성을 확인하세요.

설치 버전 기록하고 다시 설치하기

Windows PowerShell에서 현재 환경의 목록을 자신이 만든 requirements.txt에 기록할 수 있습니다.

.\.venv\Scripts\python.exe -m pip freeze | Set-Content -Encoding utf8 requirements.txt

이 예제에서 설치한 패키지 행은 다음과 같습니다. 파일은 본문을 참고해 직접 만들거나 위 명령으로 생성하면 됩니다.

colorama==0.4.6

새 환경을 만든 뒤 그 파일로 설치하려면 다음처럼 실행합니다.

py -m venv .venv-other
.\.venv-other\Scripts\python.exe -m pip install -r requirements.txt
.\.venv-other\Scripts\python.exe -c "import colorama; from importlib.metadata import version; print(version('colorama'))"

두 환경은 다른 Python 경로를 가집니다. 한쪽에 설치했다고 다른 쪽에도 자동으로 설치되지는 않습니다. freeze는 현재 설치 목록을 기록하는 방법이며, Python 버전·운영체제·외부 라이브러리까지 모두 같게 만드는 잠금 파일은 아닙니다.

선택한 환경에서 패키지 삭제하기

처음 만든 .venv에서만 Colorama를 제거하는 명령입니다.

.\.venv\Scripts\python.exe -m pip uninstall colorama

제거 대상과 경로를 읽고 확인 질문에 답합니다. 이어서 아래 명령이 True인지 확인할 수 있습니다.

.\.venv\Scripts\python.exe -c "import importlib.util; print(importlib.util.find_spec('colorama') is None)"

이때 .venv-other에 설치한 패키지는 별개입니다. 시스템 전체의 Python이나 다른 프로젝트에서 지워졌다는 뜻은 아닙니다.

자주 막히는 오류 구분하기

증상 먼저 확인할 내용
pip을 명령으로 인식하지 못한다 실행 가능한 Python으로 -m pip 사용
No module named pip 현재 Python 배포판에 pip이 포함됐는지 확인
설치 성공 후 ModuleNotFoundError 실행·편집기·노트북이 선택한 Python 경로와 import 이름 확인
externally-managed-environment 시스템 환경 대신 프로젝트 가상환경 사용
인증서·프록시·연결 오류 네트워크·기관 프록시 설정과 정확한 오류 확인

Python 배포판이 지원한다면 python -m ensurepip --upgrade로 pip을 준비할 수 있습니다. 모든 배포판에 같은 방식이 제공되는 것은 아니므로 공식 설치 안내를 확인하세요. 연결 오류를 해결하려고 인증서 검사를 무조건 끄는 옵션부터 붙이지 않습니다.

macOS·Linux에서 같은 예제를 실행하려면

가상환경의 실행 경로가 다릅니다. 아래는 공식 가상환경 방식에 따른 명령 예시입니다.

python3 -m venv .venv
.venv/bin/python -m pip install colorama==0.4.6
.venv/bin/python -c "import colorama; from importlib.metadata import version; print(version('colorama'))"

운영체제나 Python 배포판에서 별도의 venv 패키지를 요구한다면 해당 배포판의 설치 안내를 따르세요.

목적별 가이드

하려는 일 가이드
Python과 pip 경로 맞추기 환경 확인
다른 프로젝트와 분리해 설치 가상환경 만들기
설치 후 실행까지 확인 패키지 설치와 import
버전을 기록해 새 환경에 복원 설치 목록 기록과 복원
이 환경의 패키지만 제거 패키지 삭제
Python 프로젝트와 잠금·재현 환경 확인uv Python 가이드

2026년 10월 16일 Windows 11 Sandbox의 Python 3.12 시험 환경에서 가상환경 생성, 고정 버전 설치·import·목록 확인, 기록을 이용한 복원, 한 환경의 제거가 다른 환경에 영향을 주지 않는 결과를 확인했습니다. macOS·Linux 명령은 공식 절차를 대조한 예시이며 해당 OS에서 직접 실행하지 않았습니다. 독자의 기존 프로젝트나 시스템 패키지를 검사한 결과는 아닙니다.

참고 자료