🔥 파이썬 가상 환경 venv의 모든 것!

#python#venv
1563자
23분

강의 목차

1. 파이썬 가상 환경 (venv)

파이썬 개발을 하다 보면 여러 프로젝트를 동시에 진행하게 되는 경우가 많은데요, 각각의 프로젝트에서 사용하는 라이브러리의 버전이 다르거나, 프로젝트별로 격리된 환경을 만들고 싶을 때가 있습니다. 이럴 때 필요한 것이 바로 '파이썬 가상 환경'이죠. 파이썬 가상 환경은 각 프로젝트를 독립적인 공간에서 관리할 수 있게 해주는 유용한 도구입니다.

가상 환경 소개

파이썬 가상 환경은 'venv'라는 모듈을 통해 생성되는데요, 이 모듈은 파이썬에 기본적으로 포함되어 있어 별도의 설치 과정이 필요 없습니다. 가상 환경을 사용함으로써, 시스템 전체에 영향을 미치지 않고 특정 프로젝트에 필요한 패키지만을 설치하고 관리할 수 있게 됩니다. 이는 프로젝트의 의존성 관리를 효율적으로 하고, 다양한 환경에서의 호환성 문제를 최소화하는 데 도움을 줍니다.

활성화와 비활성화

가상 환경을 사용할 때 중요한 점은 활성화와 비활성화입니다. 가상 환경을 활성화하면 해당 환경에 설치된 파이썬 인터프리터와 라이브러리를 사용할 수 있게 되고, 비활성화하면 원래의 시스템 환경으로 돌아가게 됩니다. 이를 통해 프로젝트별로 필요한 환경을 쉽게 전환할 수 있게 되죠. 이 섹션에서는 가상 환경을 어떻게 활성화하고 비활성화하는지, 그리고 이 과정에서 주의할 점들에 대해 알아보도록 하겠습니다.

가상 환경 생성하기

가상 환경을 만드는 것은 생각보다 간단합니다. 명령어 한 줄이면 새로운 가상 환경을 생성할 수 있죠. 여기서는 venv 모듈을 사용하여 가상 환경을 어떻게 생성하는지, 생성 후 가상 환경 폴더 구조는 어떻게 되는지 등을 살펴볼 겁니다. 이 과정을 통해 가상 환경의 기본적인 설정과 구조에 대해 이해할 수 있게 될 것입니다.

의존성 관리

가상 환경에서는 각 환경마다 필요한 의존성을 따로 관리할 수 있습니다. 이는 서로 다른 프로젝트에서 발생할 수 있는 패키지 충돌을 방지해줍니다. 여기서는 가상 환경에 패키지를 설치하고 관리하는 방법, 그리고 필요한 패키지 목록을 관리하는 방법에 대해 알아보겠습니다. 의존성 관리는 프로젝트의 안정성과 재현성을 높이는 데 중요한 역할을 합니다.

가상 환경은 파이썬 개발에 있어서 매우 중요한 부분입니다. 이번 글을 통해 여러분도 파이썬 가상 환경을 효과적으로 사용하는 방법을 익히게 되길바라며, 이를 통해 더욱 체계적이고 안정적인 파이썬 개발 환경을 구축할 수 있게 되기를 기대합니다.

2. 가상 환경 소개

파이썬을 사용하는 개발자라면 누구나 한 번쯤은 '가상 환경'이라는 용어를 들어봤을 겁니다. 가상 환경은 파이썬 개발의 필수 요소라고 할 수 있죠. 이번 섹션에서는 가상 환경이 무엇이며, 왜 사용하는지에 대해 쉽고 자세하게 설명하고자 합니다. 또한, 이를 통해 파이썬 개발의 효율성과 안정성을 어떻게 향상시킬 수 있는지에 대해서도 알아보겠습니다.

가상 환경이란 무엇인가요?

가상 환경은 말 그대로 '가상'의 환경을 만드는 것을 의미합니다. 파이썬에서 가상 환경을 사용하면, 마치 별도의 독립된 파이썬 인스턴스를 만드는 것과 같은 효과를 얻을 수 있어요. 이 가상 환경 안에서는 시스템의 파이썬 인터프리터나 라이브러리와는 독립적으로 패키지를 설치하고 관리할 수 있습니다. 예를 들어, 하나의 컴퓨터에서 여러 파이썬 프로젝트를 진행할 때 각각 다른 버전의 라이브러리를 사용해야 한다면, 가상 환경을 통해 각 프로젝트마다 다른 라이브러리 설정을 유지할 수 있죠.

#### 가상 환경 생성 예시
python -m venv myprojectenv
python

이 명령어는 myprojectenv라는 이름의 새로운 가상 환경을 생성합니다. 생성된 가상 환경은 완전히 독립적이기 때문에, 이 안에서 설치되는 패키지는 다른 환경에 영향을 주지 않습니다.

왜 가상 환경을 사용하나요?

가상 환경을 사용하는 이유는 여러 가지가 있습니다. 먼저, 다양한 프로젝트에서 서로 다른 버전의 라이브러리를 사용할 경우, 이를 분리하여 관리할 수 있습니다. 예를 들어, 한 프로젝트에서는 Django 2.0을 사용하고, 다른 프로젝트에서는 Django 3.0을 사용해야 한다면, 각각의 가상 환경에서 서로 다른 버전을 설치하여 충돌 없이 작업을 진행할 수 있죠.

#### 가상 환경에서 패키지 설치 예시
pip install django==2.0
python

또한, 가상 환경을 사용하면 프로젝트의 의존성을 명확하게 관리할 수 있습니다. 프로젝트별로 requirements.txt 파일을 생성하여 필요한 패키지와 그 버전을 명시함으로써, 프로젝트를 다른 환경에서 재현할 때 필요한 패키지들을 쉽게 설치할 수 있습니다.

#### requirements.txt 파일 예시
django==2.0
requests==2.23.0
python

이러한 가상 환경의 사용법과 관리 방법을 숙지하면, 파이썬 개발을 더욱 효율적이고 체계적으로 진행할 수 있게 됩니다.

연습문제

  1. 새로운 파이썬 가상 환경을 생성하고, 해당 환경에서 Django 2.0과 requests 2.23.0을 설치해보세요.
  2. 두 개의 다른 가상 환경을 생성하고, 각각 다른 버전의 Django를 설치한 후, 각 환경에서 Django의 버전을 확인해보세요.
  3. 가상 환경을 활성화하고 비활성화하는 방법을 연습해보세요.
  4. requirements.txt 파일을 생성하고, 가상 환경에서 필요한 패키지를 설치하는 과정을 시도해보세요.
  5. 여러분이 진행하고 있는 파이썬 프로젝트에 가상 환경을 적용해보고, 그 경험을 공유해보세요.

3. 가상 환경 만들기

파이썬 개발에서 가상 환경의 중요성은 이미 알아보았습니다. 이번 섹션에서는 실제로 가상 환경을 어떻게 만드는지, 그리고 그 과정에서 필요한 단계들을 자세히 살펴보겠습니다.

venv 설치하기

가상 환경을 만들기 전에, 먼저 venv 모듈이 설치되어 있는지 확인해야 합니다. 대부분의 최신 파이썬 버전에는 venv가 기본적으로 포함되어 있으니, 별도로 설치할 필요는 없습니다. 하지만 혹시 모르니, 파이썬 버전을 확인해보는 것이 좋겠죠.

#### 파이썬 버전 확인
python --version
Python 3.11.3
python

이 명령어를 통해 현재 사용 중인 파이썬의 버전을 확인할 수 있습니다. venv는 파이썬 3.3부터 같이 설치되기 때문에 만약 파이썬 버전이 3.3보다 이전 버전이라면 파이썬을 업그레이드하거나 별도로 설치해야 합니다.

새로운 환경 만들기

venv가 준비되었다면, 이제 가상 환경을 만들어볼 시간입니다. 가상 환경을 생성하는 것은 몇 가지 간단한 단계만으로 가능합니다. 우선, 가상 환경을 생성할 디렉토리로 이동한 다음, 다음과 같은 명령어를 실행하면 됩니다.

#### 가상 환경 생성
python -m venv myenv
python

이 명령어는 현재 디렉토리에 myenv라는 이름의 가상 환경을 생성합니다. 이 가상 환경은 완전히 독립적이기 때문에, 여기에 설치되는 모든 패키지는 다른 환경에 영향을 주지 않습니다.

가상 환경을 생성한 후에는 환경을 활성화해야 합니다. Windows와 MacOS/Linux에서 활성화하는 방법이 다르니 주의해야 합니다.

Windows에서는 다음과 같이 실행합니다.

myenv\Scripts\activate
text

MacOS나 Linux에서는 아래와 같이 실행하면 됩니다.

source myenv/bin/activate
shell

이제 가상 환경이 활성화되었으니, 필요한 패키지들을 자유롭게 설치하고 관리할 수 있게 되었습니다. 가상 환경을 사용하는 것은 프로젝트의 의존성을 명확히 관리하고, 개발 환경을 효율적으로 유지하는 데 큰 도움이 됩니다.

연습문제

  1. venv 모듈을 사용하여 새로운 가상 환경을 생성해보세요.
  2. 생성된 가상 환경을 활성화하고, pip list 명령어를 사용하여 현재 설치된 패키지 목록을 확인해보세요.
  3. 가상 환경에 여러분이 자주 사용하는 패키지를 설치해보세요. 예를 들어, pip install numpy와 같이 실행할 수 있습니다.
  4. 가상 환경을 비활성화하고, 다시 활성화하는 과정을 연습해보세요.
  5. 두 개 이상의 가상 환경을 만들어서 각 환경에서 서로 다른 버전의 동일 패키지를 설치해보세요. 이를 통해 각 환경이 독립적으로 작동하는 것을 확인해보세요.

4. 가상환경 활성화와 비활성화

가상 환경을 사용하는 과정에서 가장 기본이 되는 단계는 바로 '활성화'와 '비활성화'입니다. 이번 섹션에서는 가상 환경을 어떻게 활성화하고 비활성화하는지 자세히 알아 보겠습니다.

환경 활성화하기

가상 환경을 활성화하는 것은 해당 환경에 설치된 파이썬 인터프리터와 라이브러리를 사용할 수 있게 만드는 과정입니다. 활성화 방법은 운영체제에 따라 조금씩 다르지만, 기본적인 명령어는 비슷합니다.

Windows에서는 다음과 같이 환경을 활성화할 수 있습니다.

myenv\Scripts\activate
text

MacOS나 Linux에서는 다음과 같이 환경을 활성화합니다.

source myenv/bin/activate
shell

이 명령어들은 myenv라는 이름의 가상 환경을 활성화합니다. 활성화가 되면, 콘솔이나 터미널의 프롬프트가 변경되어 활성화된 환경의 이름을 보여주게 됩니다.

환경 비활성화하기

가상 환경을 사용한 후에는 비활성화하는 것이 중요합니다. 비활성화는 간단하게 다음 명령어로 수행할 수 있습니다.

deactivate
shell

이 명령어는 현재 활성화된 가상 환경을 비활성화하고 원래의 시스템 환경으로 돌아가게 합니다. 비활성화 후에는 가상 환경에 설치된 파이썬 인터프리터나 라이브러리에 접근할 수 없게 되죠.

연습문제

  1. 새로운 가상 환경을 생성하고, 해당 환경을 활성화해보세요.
  2. 활성화된 환경에서 몇 가지 패키지를 설치해보고, pip list 명령어로 설치된 패키지 목록을 확인해보세요.
  3. 가상 환경을 비활성화하고, 비활성화된 상태에서 pip list 명령어를 다시 실행해보세요. 어떤 차이가 있는지 확인해보세요.
  4. 여러 번 활성화와 비활성화를 반복해보면서, 환경이 바뀔 때마다 콘솔이나 터미널의 프롬프트가 어떻게 변하는지 관찰해보세요.
  5. 다른 가상 환경을 생성하고, 이전에 생성한 환경과는 다른 패키지를 설치해보세요. 이를 통해 각 환경이 독립적으로 작동하는 것을 확인해보세요.

5. 의존성 관리

파이썬 프로젝트를 진행하면서 가장 중요한 부분 중 하나는 바로 '의존성 관리'입니다. 의존성 관리는 프로젝트에서 사용하는 외부 라이브러리들을 효율적으로 관리하는 것을 의미하는데요, 이번 섹션에서는 의존성 관리의 기본적인 방법과 팁들을 알아보도록 하겠습니다. 올바른 의존성 관리는 프로젝트의 안정성과 재현성을 보장하기 위해 꼭 필요합니다.

패키지 설치하기

의존성 관리의 첫걸음은 필요한 패키지들을 설치하는 것입니다. 파이썬에서는 pip라는 패키지 관리자를 사용하여 손쉽게 다양한 패키지를 설치할 수 있습니다. 예를 들어, numpy 패키지를 설치하고 싶다면 다음과 같은 명령어를 사용합니다.

#### numpy 패키지 설치
pip install numpy
python

가상 환경을 사용할 때는 해당 환경을 활성화한 상태에서 패키지를 설치해야 합니다. 이렇게 하면 설치된 패키지들이 해당 가상 환경에만 영향을 미치게 되죠.

requirements 파일

파이썬 프로젝트에서 의존성 관리의 핵심은 requirements.txt 파일에 있습니다. 이 파일에는 프로젝트를 실행하는 데 필요한 모든 패키지와 그 버전이 명시되어 있죠. pip freeze 명령어를 사용하면 현재 가상 환경에 설치된 패키지들의 목록과 버전을 볼 수 있습니다.

#### 현재 환경의 패키지 목록과 버전 출력
pip freeze
python

이 명령어의 출력 결과를 requirements.txt 파일에 저장하면, 다른 개발 환경에서도 동일한 설정으로 의존성을 재현할 수 있습니다.

#### requirements.txt 파일에 저장
pip freeze > requirements.txt
python

이렇게 생성된 requirements.txt 파일은 프로젝트의 중요한 부분이며, 버전 관리 시스템에도 함께 포함시켜야 합니다. 다른 개발자나 배포 환경에서 이 파일을 사용하여 필요한 모든 패키지를 쉽게 설치할 수 있기 때문이죠.

requirements.txt 적용하기

requirements.txt 파일은 파이썬 프로젝트의 의존성을 관리하는 데 있어 핵심적인 역할을 합니다. 이 파일에는 프로젝트를 실행하는 데 필요한 패키지와 그 정확한 버전이 명시되어 있죠. 이제 우리는 이 파일을 어떻게 새로 만든 가상 환경에 적용하는지 알아보겠습니다.

새로운 가상 환경에 requirements.txt 파일을 적용하는 과정은 매우 간단합니다. 먼저, 새로운 가상 환경을 활성화해야 합니다. 환경이 활성화되었다면, pip를 사용하여 requirements.txt 파일에 명시된 모든 패키지를 일괄 설치할 수 있습니다.

#### 가상 환경 활성화 (Windows)
myenv\Scripts\activate
 
#### 가상 환경 활성화 (MacOS/Linux)
source myenv/bin/activate
python

가상 환경이 활성화된 상태에서 다음과 같은 명령어를 사용하여 requirements.txt 파일에 명시된 패키지들을 설치합니다.

#### requirements.txt 파일에 명시된 패키지 일괄 설치
pip install -r requirements.txt
python

이 명령어는 requirements.txt 파일에 나열된 모든 패키지와 그 정확한 버전을 가상 환경에 설치합니다. 이 과정을 통해 다른 개발 환경이나 배포 환경에서도 프로젝트의 의존성을 빠르고 정확하게 재현할 수 있게 됩니다.

이렇게 requirements.txt 파일을 적용하는 방법을 사용하면, 프로젝트의 의존성을 효과적으로 관리하고, 프로젝트의 재현성을 보장할 수 있습니다. 특히 팀 단위의 프로젝트나 오픈 소스 프로젝트에서 이 방법은 매우 유용하게 사용됩니다.

연습문제

  1. 가상 환경을 만들고, 여러 개의 패키지를 설치해보세요. 예를 들어 numpy, pandas 등을 설치해 볼 수 있습니다.
  2. pip freeze 명령어를 사용하여 현재 가상 환경에 설치된 패키지 목록과 버전을 확인해보세요.
  3. 이 목록을 requirements.txt 파일에 저장해보세요.
  4. 새로운 가상 환경을 만들고, requirements.txt 파일을 사용하여 패키지들을 일괄 설치해보세요.
  5. 여러분이 진행 중인 파이썬 프로젝트에 requirements.txt 파일을 만들고, 이를 통해 의존성을 관리하는 방법을 시도해보세요.