파이썬 가상환경 활성화 방법: Windows, macOS, Linux 명령어 정리

작성자:

가상환경을 만들었는데도 패키지 설치나 실행이 꼬인다면, 가장 먼저 확인할 것은 가상환경이 실제로 활성화돼 있는지입니다. 운영체제와 셸에 따라 명령어가 조금씩 다르기 때문에 입문자가 가장 자주 헷갈리는 부분입니다.

Windows PowerShell에서 활성화

venv\Scripts\Activate.ps1

PowerShell에서는 실행 정책 때문에 처음에 경고가 나올 수 있습니다. 그 경우 PowerShell 실행 정책을 먼저 확인해야 합니다.

Windows CMD에서 활성화

venv\Scripts\activate.bat

명령 프롬프트에서는 보통 위 명령어로 바로 활성화됩니다.

macOS와 Linux에서 활성화

source venv/bin/activate

source 명령으로 현재 셸에 가상환경 설정을 적용합니다.

활성화됐는지 확인하는 방법

보통 터미널 앞에 (venv) 같은 이름이 붙습니다. 추가로 아래 명령어를 같이 보면 더 확실합니다.

python --version
python -m pip --version

이때 python과 pip가 가상환경 경로를 가리키면 정상입니다.

비활성화는 어떻게 할까

deactivate

작업이 끝난 뒤 원래 환경으로 돌아가려면 deactivate를 입력하면 됩니다.

자주 생기는 문제

1. activate 명령이 안 먹는 경우

현재 위치가 프로젝트 폴더가 아니거나, 가상환경 폴더 이름이 venv가 아닐 수 있습니다.

2. 활성화했는데도 패키지가 안 보이는 경우

python -m pip --version으로 실제 연결된 환경을 확인해야 합니다.

3. VS Code에서는 다른 파이썬이 잡히는 경우

터미널 가상환경 활성화와 별개로, VS Code 인터프리터 선택도 맞춰야 합니다.

정리

  • Windows와 macOS/Linux는 활성화 명령어가 다릅니다.
  • 활성화 여부는 터미널 프롬프트와 python -m pip --version으로 확인하는 것이 가장 정확합니다.
  • VS Code를 쓰는 경우 인터프리터 선택까지 같이 봐야 꼬이지 않습니다.

함께 보면 좋은 글:

댓글 남기기