Python 가상 환경을 생성하고 활성화하는 방법

내장된 venv 모듈을 사용하여 Python 가상 환경을 생성, 활성화 및 관리하는 방법을 알아보세요. 프로젝트 종속성을 격리되고 깔끔하게 유지하세요.

개요

Python 애플리케이션을 개발할 때 pip를 사용하여 타사 패키지를 설치하는 경우가 많습니다. 가상 환경이 없으면 이러한 패키지는 시스템의 Python 환경에 전역적으로 설치됩니다. 이는 서로 다른 프로젝트에 동일한 라이브러리의 서로 다른 버전이 필요한 경우 빠르게 충돌로 이어질 수 있습니다(예: 프로젝트 A에는Django3.2가 필요하고 프로젝트 B에는Django5.0이 필요함).

가상 환경은 자체 Python 실행 파일과 설치된 패키지 세트를 포함하는 격리된 디렉터리입니다. 각 프로젝트에 대한 가상 환경을 생성하면 패키지 설치가 다른 프로젝트나 시스템 전체 Python 설정을 방해하지 않는지 확인할 수 있습니다. 이는 Python 개발을 위한 기본적인 모범 사례입니다.

최신Python 3에서 표준 라이브러리에는 외부 도구 없이 가상 환경을 처리하는 'venv' 모듈이 포함되어 있습니다. 가상 환경의 수명주기에는 환경 디렉터리 생성, 활성 터미널 세션에서 활성화, 종속성 설치, 완료 시 최종 비활성화가 포함됩니다.

코드 및 실행 출력

이 시뮬레이션은 macOS/Linux 및 Windows에서 가상 환경 내에서 패키지를 생성, 활성화, 설치 및 비활성화하는 데 사용되는 터미널 명령을 표시합니다.

virtual_env.py

에디터에서 사용해 보세요

commands_macos_linux = """
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate
"""

commands_windows = """
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate
"""

print("macOS & Linux terminal commands:")
print(commands_macos_linux.strip())
print("\nWindows terminal commands:")
print(commands_windows.strip())

터미널 출력

macOS & Linux terminal commands:
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate

Windows terminal commands:
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate

단계별 구현

프로젝트 터미널에서 python -m venv <env_name>을 실행하여 환경 파일을 생성합니다.
소스 <env_name>/bin/activate(macOS/Linux) 또는 <env_name>\Scripts\activate(Windows)를 사용하여 환경을 활성화합니다.
pip install을 사용하여 필수 패키지를 설치하여 이 프로젝트 디렉터리에 격리되도록 합니다.
작업을 마친 후 가상 환경을 종료하려면 터미널 셸에 deactivate를 입력하세요.