Windows에 Python 설치하고 프로젝트 가상환경 만들기

1. 설치 관리자와 런타임 구분

Python 공식 Windows 문서는 Python install manager를 통해 런타임을 관리하는 방식을 안내합니다. 공식 다운로드에서 관리자와 Python 실행 환경의 역할을 읽고 설치합니다. 기존 IDE나 다른 프로그램이 이미 Python을 제공하고 있다면 새 설치 전에 사용 중인 버전과 경로를 확인하세요. 프로젝트에 고정된 버전 요구사항이 있다면 지원되는 범위 안에서 맞는 런타임을 선택합니다.

2. 새 터미널에서 실행 상태 확인

설치 뒤 새 PowerShell을 열어 python --version을 실행합니다. 명령을 찾지 못하거나 Store가 열리면 Windows용 공식 문서의 명령 별칭과 설치 관리자 상태를 확인합니다. py --version도 함께 확인하면 다른 진입점의 동작을 비교할 수 있습니다. 두 명령의 출력이 다르면 여러 설치가 존재할 수 있으므로 어느 Python으로 환경을 만들지 먼저 정합니다.

python --version
py --version

3. 프로젝트 폴더 안에 가상환경 생성

탐색기에서 연습용 프로젝트 폴더를 만든 뒤 그 폴더에서 PowerShell을 엽니다. 아래 명령은 현재 폴더 안의 .venv에 Python 실행 파일과 프로젝트 패키지 공간을 만듭니다. .venv라는 이름은 관례이고 소스 파일은 그 바깥에 둡니다. 생성에 실패했다면 쓰기 가능한 폴더인지와 사용 중인 Python 배포본이 venv를 제공하는지부터 확인합니다.

python -m venv .venv

4. 만든 환경의 실행 파일로 확인

가상환경을 활성화하지 않아도 그 안의 Python 경로를 직접 지정할 수 있습니다. 다음 명령은 현재 폴더의 .venv에 있는 실행 파일을 호출합니다. 경로가 없다고 나오면 명령을 실행한 폴더와 생성 결과를 확인하세요. 이 방식은 셸의 활성화 스크립트가 조직 정책으로 제한된 상황에서도 어느 실행 파일을 사용하려는지 명확하게 보여 줍니다.

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

5. 패키지 설치 위치 혼동 줄이기

pip를 단독으로 실행하면 다른 Python에 연결된 명령이 선택될 수 있습니다. 프로젝트 환경의 실행 파일 뒤에 -m pip를 붙이면 같은 환경의 패키지 관리자를 호출합니다. 아직 필요한 패키지를 정하지 않았다면 먼저 목록만 확인하세요. 외부 패키지를 추가할 때는 패키지 이름과 공식 프로젝트 출처를 확인하고, 설치 기록을 프로젝트의 의존성 파일로 관리합니다.

.\.venv\Scripts\python.exe -m pip list

6. 활성화와 종료 이해

공식 가이드의 Windows 활성화 명령을 사용하면 매번 긴 Python 경로를 쓰는 일을 줄일 수 있습니다. 다만 PowerShell 실행 정책이 스크립트를 차단하면 정책을 전체 해제하기보다 앞 단계처럼 실행 파일을 직접 지정할 수 있습니다. 활성화한 셸에서 작업을 마칠 때는 deactivate로 원래 명령 탐색 상태로 돌아갑니다. 터미널을 닫아도 프로젝트 파일은 남습니다.

7. 환경을 다시 만들 때 남길 자료

가상환경은 프로젝트에 맞춰 다시 만들 수 있지만 소스 파일과 설정·의존성 목록은 별도로 보관해야 합니다. Python 런타임을 바꿀 때 기존 .venv를 그대로 옮겨 쓰기보다 필요한 버전으로 새 환경을 만들고 의존성을 다시 설치합니다. 실행이 안 되면 오류 원문, Python 버전, 사용한 실행 경로를 기록하고 패키지 문제와 실행 환경 문제를 구분하세요.