파이썬 가상환경 설정 완벽 가이드: 초보자도 쉽게 따라하기

공부/기술

파이썬 가상환경 설정 완벽 가이드: 초보자도 쉽게 따라하기

휴전 2024. 8. 29. 15:45

파이썬 개발을 하다 보면 프로젝트마다 다른 패키지 버전을 사용해야 할 때가 있습니다. 이럴 때 유용한 것이 바로 가상환경입니다. 가상환경을 통해 프로젝트 간의 의존성을 분리하여 관리할 수 있습니다. 이 글에서는 파이썬 가상환경을 설정하는 방법을 단계별로 자세히 설명하겠습니다.


1. Python 설치 확인

먼저, 파이썬이 설치되어 있는지 확인해야 합니다. 터미널(또는 CMD)에서 다음 명령어를 입력하세요:

python --version​
또는
python3 --version
 

위 명령어를 통해 설치된 파이썬의 버전을 확인할 수 있습니다. 만약 파이썬이 설치되어 있지 않다면 Python 공식 웹사이트에서 다운로드 및 설치를 진행하세요.

 

 

2. 가상환경 모듈 설치 (필요 시)

일반적으로 Python 3.3 이상 버전에는 venv 모듈이 내장되어 있습니다. 하지만, 만약 설치가 되어 있지 않다면 아래 명령어를 통해 설치할 수 있습니다.

pip install virtualenv

 

3. 가상환경 생성

 

가상환경을 생성할 디렉토리로 이동한 후, 아래 명령어를 사용해 가상환경을 만드세요. 예를 들어, myenv라는 이름의 가상환경을 만들고 싶다면 다음과 같이 입력합니다:

python -m venv myenv

 

 

또는 Python 3을 사용 중이라면:

python3 -m venv myenv
 

myenv라는 폴더가 생성되며, 그 안에 가상환경이 설정됩니다.

 

4. 가상환경 활성화

 

가상환경을 활성화하려면 OS에 따라 다음 명령어를 사용하세요.

  • Windows:
myenv\Scripts\activate
  • macOS/Linux:
source myenv/bin/activate

 

활성화된 가상환경에서는 프롬프트 앞에 (myenv)가 표시됩니다.

 

5. 패키지 설치 및 관리

 

가상환경이 활성화된 상태에서 pip를 사용하여 패키지를 설치할 수 있습니다. 예를 들어, requests 라이브러리를 설치하려면 다음과 같이 입력하세요:

pip install requests
 

설치된 패키지 목록을 확인하려면:

pip list

 

6. 가상환경 비활성화

 

작업이 끝났다면 가상환경을 비활성화할 수 있습니다. 비활성화하려면 다음 명령어를 입력하세요:

deactivate

 

가상환경에서 벗어나 로컬 환경으로 돌아갑니다.

 

7. 가상환경 삭제

 

가상환경을 삭제하고 싶다면 해당 가상환경 폴더 (myenv)를 삭제하면 됩니다. 폴더를 삭제하면 가상환경도 삭제됩니다.

rm -rf myenv

 

이 명령어는 myenv 폴더와 그 안의 모든 내용을 강제로(-rf 옵션) 삭제합니다. 가상환경을 삭제할 때는 이 명령어를 사용하시면 됩니다.


이제 파이썬 가상환경 설정에 대해 완벽히 이해하셨을 겁니다. 이를 통해 프로젝트마다 독립적인 환경을 관리하여 개발 효율성을 높일 수 있습니다.