Python 프로젝트를 진행하다 보면 시스템 전역 환경을 오염시키지 않기 위해 virtualenv(가상 환경) 안에 라이브러리를 설치해야 하는 경우가 많습니다. 이 글에서는 macOS 10.7(Lion) 환경에서 터미널 명령어만으로 virtualenv 내부에 Matplotlib을 설치하고 설치 결과까지 확인하는 과정을 단계별로 정리했습니다.
1단계: 가상 환경 생성하기
먼저 터미널을 열고 아래 명령어로 새로운 가상 환경을 만듭니다.
virtualenv env여기서 env는 가상 환경의 이름으로, 프로젝트 성격에 맞게 자유롭게 변경할 수 있습니다.
2단계: 가상 환경 활성화하기
생성한 가상 환경을 사용하려면 먼저 활성화해야 합니다.
source env/bin/activate명령어 실행 후 프롬프트 앞에 (env)가 표시되면 해당 가상 환경에 정상적으로 진입한 것입니다.
3단계: Matplotlib 설치하기
활성화된 상태에서 pip를 이용해 Matplotlib을 설치합니다.
pip install matplotlib이렇게 하면 Matplotlib이 시스템 전역이 아닌 현재 가상 환경에만 설치되므로, 다른 프로젝트와의 의존성 충돌을 걱정할 필요가 없습니다.
4단계: 설치된 패키지 목록 파일로 저장하기
설치된 패키지와 버전 정보를 requirements.txt 파일에 기록해 두면 나중에 동일한 개발 환경을 손쉽게 재현할 수 있습니다.
pip freeze > requirements.txt5단계: 설치 결과 확인하기
마지막으로 파일 내용을 출력해 Matplotlib의 설치 여부와 버전 정보를 확인합니다.
cat requirements.txt목록에 Matplotlib 항목이 보인다면 가상 환경에 성공적으로 설치된 것입니다.
참고 사항
macOS 10.7은 비교적 오래된 운영체제이기 때문에 최신 버전의 Matplotlib과 호환되지 않을 수 있습니다. 설치 중 오류가 발생한다면 아래와 같이 특정 구버전을 지정해 설치하는 방법을 시도해 보세요.
pip install matplotlib==1.x.x또한 Python 개발 도구 및 컴파일러가 제대로 설치되어 있는지도 함께 점검하면 문제 해결에 도움이 됩니다.