Virtualenv는 Python 프로젝트를 위해 격리된 가상 환경을 생성해 주는 도구입니다. 이 도구는 Python 프로젝트 실행에 필요한 실행 파일들을 포함한 폴더를 만들어 주며, 프로젝트 간 의존성 충돌을 방지하는 데 필수적으로 활용됩니다. 그러나 최근 macOS 사용자들을 중심으로 Virtualenv 명령어가 실행되지 않고 '명령을 찾을 수 없음(Command Not Found)' 오류가 발생한다는 신고가 다수 접수되었습니다.
Virtualenv '명령을 찾을 수 없음' 오류가 발생하는 원인
여러 사용자로부터 접수된 신고를 바탕으로 문제를 조사했으며, 이를 완전히 해결할 수 있는 솔루션을 마련했습니다. 또한 오류가 발생하는 원인을 분석하여 아래와 같이 정리했습니다.
- 잘못된 설치 경로: 특정 "pip" 명령어로 프로그램을 설치하면 "/usr/local/bin"이 아닌 다른 디렉터리에 설치될 수 있습니다. Virtualenv가 정상적으로 작동하려면 반드시 "/usr/local/bin" 디렉터리에 설치되어야 하므로, 이 경우 오류가 발생하게 됩니다.
- 관리자 권한 부족: 프로그램이 올바른 디렉터리에 설치되고 명령어가 시스템에 인식되려면 관리자(Superuser) 권한으로 설치해야 합니다. 일반 사용자 권한으로 설치한 경우 이 오류가 트리거될 수 있습니다.
문제의 원인을 어느 정도 이해하셨다면, 이제 해결 방법으로 넘어가겠습니다. 설정 간 충돌을 피하기 위해 아래 솔루션들은 제시된 순서대로 하나씩 적용하는 것을 권장합니다.
해결 방법 1: 설치 디렉터리 변경
프로그램이 올바른 디렉터리에 설치되지 않은 경우 이 오류가 발생할 수 있습니다. 따라서 이 단계에서는 설치 위치를 올바른 디렉터리로 변경해 보겠습니다.
- 화면 우측 상단의 "Spotlight 검색(돋보기)"을 클릭합니다.
- "Terminal(터미널)"을 입력하고 첫 번째 결과를 선택합니다.
- 아마도 다음 명령어로 프로그램을 설치하셨을 것입니다.
pip install virtualenv
- 아래 명령어를 입력하고 "Enter" 키를 누릅니다.
sudo /usr/bin/easy_install virtualenv
- 이제 프로그램이 적절한 디렉터리에 배치됩니다. 문제가 지속되는지 확인합니다.
해결 방법 2: 관리자 권한으로 재설치
프로그램이 일반 사용자 권한으로 설치되어 루트(root) 권한이 부여되지 않았기 때문에 오류가 발생했을 가능성이 있습니다. 따라서 이 단계에서는 기존 설치를 제거한 후 루트 권한으로 다시 설치해 보겠습니다.
- 화면 우측 상단의 "Spotlight 검색(돋보기)"을 클릭합니다.
- "Terminal(터미널)"을 입력하고 첫 번째 결과를 선택합니다.
- 먼저 다음 명령어를 입력하고 "Enter" 키를 눌러 기존 설치를 제거합니다.
pip uninstall virtualenv
- 이어서 다음 명령어를 입력하고 "Enter" 키를 누릅니다.
sudo pip install virtualenv
- 이제 프로그램이 관리자 권한으로 설치됩니다. 문제가 지속되는지 확인합니다.
해결 방법 3: APT-GET 방식으로 설치
일부 경우에는 "pip" 명령어로 설치해도 문제가 해결되지 않습니다. 이럴 때는 "APT-GET" 명령어를 통해 virtualenv를 설치하는 방법을 시도해 볼 수 있습니다.
- 화면 우측 상단의 "Spotlight 검색(돋보기)"을 클릭합니다.
- "Terminal(터미널)"을 입력하고 첫 번째 결과를 선택합니다.
- 다음 명령어를 입력하고 "Enter" 키를 누릅니다.
sudo apt-get install python-virtualenv
- 오류가 해결되었는지 확인합니다.