맥에서 여러 파이썬 프로젝트를 시작하려고 하는데, 각 프로젝트마다 필요한 라이브러리 버전이 달라 충돌할까 봐 걱정되시나요? 기존 개발 환경이 엉망이 될까 봐 선뜻 새로운 프로젝트를 시작하지 못하는 경우가 많습니다.
이러한 문제는 파이썬 전역 환경에서 모든 라이브러리를 공유할 때 발생합니다.
이 글에서는 맥OS에서 파이썬 내장 모듈인 `venv`를 활용해 프로젝트별로 완벽히 독립적인 가상환경을 구축하고 관리하는 구체적인 방법을 단계별로 안내합니다.
– 파이썬 가상환경은 라이브러리 버전 충돌을 완벽하게 방지합니다.
– 맥에서는 내장 모듈 `venv`로 가상환경을 손쉽게 만들 수 있습니다.
– 가상환경 활성화, 패키지 설치, 비활성화 등 필수 사용법을 3단계로 익힐 수 있습니다.
이 가이드는 맥(Mac)에서 파이썬 가상환경을 설정하여 버전 충돌 없이 각 프로젝트를 깔끔하게 시작하는 초보자를 위한 방법을 알려줍니다.
파이썬 가상환경, 왜 필요할까요?
파이썬 프로젝트를 여러 개 진행하다 보면 라이브러리 버전 충돌은 피할 수 없는 문제입니다. 특정 프로젝트는 A 라이브러리의 1.0 버전을, 다른 프로젝트는 2.0 버전을 필요로 할 때, 전역 환경에 모두 설치하면 예상치 못한 오류를 겪게 됩니다.
가상환경은 각 파이썬 프로젝트에 독립적인 ‘개발 공간’을 제공하여 이 문제를 해결합니다. 프로젝트별로 필요한 라이브러리를 분리 설치하므로, 서로 다른 버전의 라이브러리 충돌 걱정 없이 100% 독립적인 환경에서 개발할 수 있습니다.
가상환경을 사용하면 `requirements.txt` 파일 하나로 프로젝트 의존성을 정확히 명시하고, 새로운 환경에서도 단 한 번의 명령으로 모든 의존성을 설치할 수 있습니다. 이는 협업에서도 큰 장점입니다.
Photo by Owen.outdoors on Pexels
`venv`로 맥에 파이썬 가상환경 만들기 (3단계)
맥OS는 파이썬 3부터 `venv` 모듈을 내장하고 있어, 별도 설치 없이 터미널 명령 몇 줄로 가상환경을 만들 수 있습니다. 단 5분이면 독립적인 개발 환경 구축이 완료됩니다.
시작 전, `python3 –version` 명령으로 파이썬 3 설치 여부를 확인하세요. 개발 용도로는 Homebrew를 통한 최신 버전 설치를 권장합니다.
- 프로젝트 디렉토리 생성 및 이동 — 가상환경을 만들 프로젝트 폴더를 생성하고 해당 폴더로 이동합니다.
mkdir my_project cd my_project - 가상환경 생성 — `venv` 모듈을 사용해 가상환경을 생성합니다. 일반적으로 가상환경 폴더 이름은 `venv`로 합니다.
python3 -m venv venv이 명령은 현재 디렉토리 안에 `venv`라는 폴더를 만들고, 그 안에 독립적인 파이썬 실행 파일과 `pip`를 구축합니다.
- 가상환경 활성화 — 생성된 가상환경을 현재 터미널 세션에 적용합니다.
source venv/bin/activate명령을 입력하면 터미널 프롬프트 앞에 `(venv)`와 같은 형태로 가상환경 이름이 표시됩니다. 이는 가상환경이 성공적으로 활성화되었음을 의미합니다.
Photo by Prajwal Bajracharya on Pexels
가상환경 사용 및 관리 핵심 팁
가상환경 활성화 후에는 `pip install` 명령으로 필요한 라이브러리를 설치합니다. 이 라이브러리는 현재 활성화된 가상환경에만 설치되며, 전역 파이썬 환경에 영향을 주지 않습니다. 예를 들어 `pip install django`로 Django를 설치할 수 있습니다.
프로젝트 개발을 마치거나 다른 프로젝트로 전환 시에는 `deactivate` 명령으로 가상환경을 비활성화합니다. 언제든 `source venv/bin/activate` 명령으로 재활성화할 수 있습니다.
가상환경 폴더(예: `venv/`)는 `.gitignore`에 추가하여 버전 관리에서 제외하는 것이 좋습니다. 또한, 이 폴더를 수동으로 삭제하면 가상환경 자체가 제거되므로 주의해야 합니다.
가상환경을 완전히 제거하려면, 비활성화 후 해당 가상환경 폴더를 삭제하면 됩니다. `rm -rf venv` 명령으로 약 3초 안에 깔끔하게 정리할 수 있습니다.
맥에서 파이썬 가상환경을 설정하는 것은 라이브러리 버전 충돌을 방지하고 프로젝트 개발을 깔끔하게 유지하는 가장 기본적인 방법입니다. `venv` 모듈을 통해 단 3단계 만에 독립적인 환경을 구축하고, `pip`로 패키지를 관리하며, `activate`/`deactivate`로 손쉽게 전환할 수 있습니다.
지금 바로 적용해 보세요.
- Python venv — Creation of virtual environments — 파이썬 공식 문서에서 `venv` 모듈의 상세한 사용법을 확인할 수 있습니다.
- pip documentation — 파이썬 패키지 설치 도구 `pip`의 공식 가이드입니다.
동영상으로 보는 맥 파이썬 가상환경 설정 초보자 가이드
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. 왜 파이썬 가상환경을 사용해야 하나요?
A. 파이썬 프로젝트마다 필요한 라이브러리 버전이 다를 수 있기 때문입니다. 가상환경은 각 프로젝트를 위한 독립적인 작업 공간을 만들어, 서로 다른 프로젝트 간의 라이브러리 충돌을 방지하고 시스템 파이썬 환경을 깔끔하게 유지하는 데 도움을 줍니다. 이를 통해 특정 프로젝트에 맞는 환경을 손쉽게 구축하고 관리할 수 있습니다.
Q. 가상환경을 만들 때 `venv`와 `conda` 중 어떤 것을 사용해야 하나요?
A. 파이썬 3.3부터 내장된 `venv` 모듈은 별도의 설치 없이 가상환경을 생성할 수 있어 가장 일반적이고 간편한 방법입니다. `conda`는 파이썬뿐만 아니라 다른 언어와 패키지까지 관리하는 강력한 환경 관리 도구이지만, 초보자라면 `venv`로 시작하여 파이썬 가상환경의 기본 개념을 익히는 것을 추천합니다.
Q. 가상환경을 활성화하고 비활성화하는 방법은 무엇인가요?
A. 가상환경을 생성한 후에는 터미널에서 `source [가상환경이름]/bin/activate` 명령어를 사용하여 활성화할 수 있습니다. 활성화되면 터미널 프롬프트 앞에 가상환경 이름이 표시되어 현재 가상환경에 진입했음을 알 수 있습니다. 작업을 마친 후에는 단순히 `deactivate`를 입력하여 비활성화할 수 있습니다.
Q. 여러 파이썬 버전을 동시에 사용해야 할 때 가상환경만으로 충분한가요?
A. 가상환경은 특정 *파이썬 인터프리터* 내에서 라이브러리 종속성을 격리하는 역할을 합니다. 만약 파이썬 3.8, 3.9 등과 같이 *서로 다른 버전의 파이썬 자체*를 관리해야 한다면, `pyenv`와 같은 도구를 함께 사용하는 것이 효과적입니다. `pyenv`로 다양한 파이썬 버전을 설치하고, 각 버전을 기반으로 가상환경을 생성하여 관리할 수 있습니다.
📚 함께 읽으면 좋은 글