Python 가상 환경 (Python Virtual Environment, venv)

Python 가상 환경(Python Virtual Environment, venv)은 Python에서 프로젝트별로 사용할 인터프리터와 패키지 설치 공간을 분리해 관리하는 환경입니다. 기본적으로 다른 환경의 설치 패키지와 구분되며, 실제 분리 범위는 생성 옵션에 따라 달라집니다. 프로젝트마다 필요한 라이브러리 버전이 다를 때 사용하고, 운영체제 전체를 새로 만드는 가상 머신과는 구별합니다.

프로젝트별 패키지 설치 공간

Python의 venv 문서는 기존 Python 설치를 바탕으로 독립적인 패키지 집합을 가진 환경을 만드는 기능을 설명합니다. 프로젝트 하나가 요구하는 라이브러리를 별도의 위치에 설치하면 다른 프로젝트의 패키지 구성에 영향을 덜 주면서 관리할 수 있습니다. 같은 라이브러리의 서로 다른 버전이 필요한 두 작업을 한 전역 설치 공간에서 번갈아 바꾸는 대신 각 환경에 따로 둘 수 있습니다.

가상 환경은 컴퓨터에 없는 Python 버전을 자동으로 새로 만드는 개념은 아닙니다. 환경을 생성할 때 사용한 Python이 기반이 되고, 그 인터프리터와 연결된 실행 파일과 패키지 디렉터리가 만들어집니다. 기본 설정은 기반 환경의 패키지와 분리되지만 --system-site-packages 옵션은 시스템 패키지에 접근하도록 바꿉니다. 가상 환경이라는 이름만 보고 모든 설치 구성에서 같은 격리 조건이 적용된다고 판단하지 않습니다.

환경 폴더는 소스 코드와 다른 역할을 맡습니다. Python 문서는 가상 환경을 다시 만들 수 있는 대상으로 설명하며 프로젝트 코드를 환경 안에 두지 않도록 안내합니다. 코드는 별도로 보관하고 의존성을 다시 설치할 자료를 관리하면 환경을 새로 만들어도 작성한 코드가 함께 사라지는 일을 피할 수 있습니다.

활성화와 실행 파일의 선택

Python 패키징 안내는 가상 환경을 만들고 활성화한 뒤 패키지를 설치하는 흐름을 설명합니다. 활성화는 셸에서 해당 환경의 실행 파일을 먼저 찾도록 경로를 조정합니다. 이후 같은 python이나 pip라는 명령을 입력해도 다른 환경의 실행 파일이 선택될 수 있습니다. 명령 이름만 같다는 이유로 동일한 인터프리터가 실행된다고 보지 않습니다.

Python의 venv 활성화 설명은 활성화가 반드시 필요한 것은 아니며 환경 안의 Python 실행 파일 경로를 직접 지정해도 된다고 설명합니다. IDE나 자동화 작업은 셸 활성화 대신 사용할 인터프리터를 직접 선택하기도 합니다. 터미널에서 설치한 패키지를 편집기에서 찾지 못하면 두 곳이 같은 환경을 쓰는지 확인합니다. 프로젝트 폴더가 같아도 선택한 Python 경로가 다르면 읽는 패키지 목록이 달라질 수 있습니다.

운영체제와 셸에 따라 활성화 파일의 위치와 형식도 다릅니다. Python 문서는 Windows의 Scripts와 POSIX 계열의 bin 디렉터리를 구별합니다. 다른 환경의 안내를 그대로 복사해 실패했다면 설치 자체의 실패인지 활성화 스크립트를 잘못 고른 것인지 나누어 봅니다. 현재 인터프리터의 경로와 설치된 패키지를 확인하는 것이 화면의 환경 이름만 읽는 것보다 구체적인 단서가 됩니다.

복구와 격리 범위의 한계

Python의 venv 이동성 설명은 환경을 일반적으로 다른 위치에 그대로 옮겨 쓰는 대상으로 보지 않습니다. 설치된 스크립트가 인터프리터의 절대 경로를 포함할 수 있기 때문입니다. 다른 컴퓨터나 폴더로 작업을 옮길 때는 필요한 Python과 패키지 정보를 바탕으로 환경을 다시 구성합니다. 환경 폴더를 통째로 복사한 것과 같은 의존성을 새 위치에 설치해 정상 실행을 확인한 것은 구별됩니다.

패키지 분리는 운영체제의 파일 접근 권한이나 네트워크 권한을 차단하는 보안 격리와 다릅니다. 환경 안에서 실행한 프로그램도 사용자 권한으로 다른 파일을 읽거나 외부 서비스에 연결할 수 있습니다. Docker 같은 컨테이너와 Python 가상 환경은 분리하는 대상이 다르므로 같은 보안 효과를 기대하지 않습니다. 복구 기록에는 Python 버전, 설치 자료와 실제 실행 결과를 함께 남겨 패키지 재설치와 프로그램 동작 확인을 연결합니다.