미니콘다는 파이썬과 Conda만 먼저 설치한 뒤, 프로젝트에 필요한 패키지를 골라 추가할 수 있는 가벼운 배포판입니다. 처음 사용한다면 conda create, conda activate, conda install 세 가지 명령어부터 익히면 됩니다. 이 글에서는 미니콘다 설치부터 가상환경 생성, 패키지 관리, 환경 백업과 복원까지 실제 작업 순서대로 설명합니다.
먼저 이것만 기억하세요. 프로젝트마다 가상환경을 하나씩 만들고, 환경을 활성화한 뒤 패키지를 설치하면 버전 충돌을 크게 줄일 수 있습니다.
자주 쓰는 Conda 명령어 한눈에 보기
이미 미니콘다를 설치했다면 아래 표부터 확인하세요. 예시의 myenv는 가상환경 이름이므로 원하는 이름으로 바꾸면 됩니다.
미니콘다(Miniconda)란?
미니콘다는 Conda 패키지 관리자와 파이썬, 실행에 필요한 최소 구성만 포함한 배포판입니다. 처음부터 많은 데이터 분석 패키지를 설치하는 아나콘다와 달리 필요한 패키지만 선택할 수 있어 설치 용량이 작고 환경 구성이 단순합니다.
여러 프로젝트에서 서로 다른 파이썬 버전이나 패키지 버전을 사용한다면 미니콘다가 특히 편리합니다. 프로젝트마다 독립된 가상환경을 만들 수 있어 한 프로젝트의 업데이트가 다른 프로젝트에 영향을 주지 않습니다.
미니콘다 설치 방법
설치 파일은 미니콘다 공식 설치 안내에서 운영체제와 CPU에 맞는 버전을 선택하는 것이 가장 안전합니다. macOS는 Apple Silicon과 Intel용 설치 파일이 다르므로 다운로드 전에 칩 종류를 확인하세요.
Windows 설치
- 공식 설치 페이지에서 Windows용 설치 파일을 내려받습니다.
- 설치 프로그램을 실행하고 사용자 범위를 선택합니다. 개인 컴퓨터라면 보통 Just Me로 충분합니다.
- 설치가 끝나면 Anaconda Prompt 또는 새 터미널을 열어
conda info를 실행합니다.
macOS·Linux 설치
공식 설치 페이지에서 환경에 맞는 그래픽 설치 파일 또는 셸 설치 파일을 선택합니다. 설치 후 터미널을 다시 열고 다음 두 명령어로 정상 설치 여부를 확인합니다.
conda --version
conda infoconda 명령어를 찾지 못한다면 터미널을 다시 시작한 뒤 conda init을 실행합니다. 셸 설정을 변경한 후에는 터미널을 다시 열어야 적용됩니다.
Conda 가상환경 생성과 사용법
가상환경은 프로젝트마다 파이썬과 패키지를 분리해 보관하는 공간입니다. 새 프로젝트를 시작할 때 환경을 하나 만들고, 작업 전에 활성화하는 습관을 들이면 좋습니다.
가상환경 만들기
conda create -n myenv python=3.12-n 뒤의 myenv는 환경 이름입니다. 프로젝트를 구분하기 쉬운 이름으로 바꾸고, python=3.12 부분에는 프로젝트에서 사용할 파이썬 버전을 지정하세요. 설치 과정에서 계속 진행할지 묻는 메시지가 나오면 y를 입력합니다.
환경 목록 확인하기
conda info --envsconda env list를 사용해도 같은 목록을 확인할 수 있습니다. 현재 활성화된 환경 옆에는 별표가 표시됩니다.
가상환경 활성화·비활성화하기
conda activate myenv
conda deactivate환경을 활성화하면 터미널 앞부분에 환경 이름이 표시됩니다. 패키지를 설치하거나 파이썬 코드를 실행하기 전에 원하는 환경이 활성화되어 있는지 확인하세요.
가상환경 이름 변경·삭제하기
conda rename -n old-name new-name
conda remove -n myenv --all삭제 명령은 환경과 그 안의 패키지를 함께 지웁니다. 필요한 환경이라면 삭제 전에 아래의 내보내기 기능으로 백업하세요.
Conda 패키지 설치와 관리
패키지를 설치하기 전에 먼저 작업할 가상환경을 활성화합니다. 다음 예시는 pandas, numpy, matplotlib을 한 번에 설치합니다.
conda activate myenv
conda install pandas numpy matplotlib자주 사용하는 패키지 명령어
# 설치된 패키지 확인
conda list
# 특정 버전 설치
conda install numpy=2.0
# 패키지 업데이트
conda update pandas
# 패키지 삭제
conda uninstall pandas
# conda-forge 채널에서 설치
conda install -c conda-forge scikit-learnpip와 conda 중 무엇을 써야 할까?
Conda 환경에서는 우선 conda install로 설치 가능한지 확인하는 편이 안전합니다. Conda 채널에 없는 패키지는 환경을 활성화한 상태에서 pip install을 사용하세요. 두 관리자를 번갈아 여러 번 사용하면 의존성 충돌을 추적하기 어려워질 수 있습니다.
conda activate myenv
python -m pip install requestspython -m pip 형태를 사용하면 현재 활성화된 파이썬 환경에 패키지가 설치되는지 확인하기 쉽습니다.
가상환경 백업과 복원
프로젝트를 다른 컴퓨터로 옮기거나 팀원과 같은 환경을 사용하려면 환경 정보를 파일로 내보냅니다. 최신 Conda에서는 conda export 명령으로 YAML과 JSON 등 여러 형식을 선택할 수 있습니다.
# 환경을 YAML 파일로 내보내기
conda export -n myenv --file environment.yml
# 다른 컴퓨터에서 환경 만들기
conda create --file environment.yml기존에 널리 사용하던 다음 명령어도 계속 사용할 수 있습니다.
conda activate myenv
conda env export > environment.yml
conda env create -f environment.yml운영체제가 다른 컴퓨터에서도 다시 만들 수 있는 환경 파일이 필요하다면 직접 설치한 패키지 중심으로 내보냅니다.
conda export -n myenv --from-history --file environment.yml미니콘다 오류가 날 때 확인할 것
conda: command not found
설치 후 열어 두었던 터미널을 닫고 새로 실행합니다. 그래도 인식되지 않으면 설치가 완료됐는지 확인한 뒤 conda init을 실행하고 터미널을 다시 시작하세요.
Run 'conda init' before 'conda activate'
conda init명령 실행 후 터미널을 완전히 닫았다가 다시 엽니다. 사용하는 셸을 지정해야 한다면 conda init zsh 또는 conda init bash처럼 입력할 수 있습니다.
패키지 충돌이 해결되지 않을 때
기존 환경에 패키지를 계속 추가하기보다 새 환경을 만들어 필요한 패키지만 다시 설치하는 편이 빠를 때가 많습니다. 설치 캐시와 사용하지 않는 파일을 정리하려면 다음 명령을 사용할 수 있습니다.
conda clean --all미니콘다 자주 묻는 질문
미니콘다와 아나콘다 중 무엇을 설치해야 하나요?
필요한 패키지만 설치하고 프로젝트별 환경을 직접 관리하려면 미니콘다가 적합합니다. 데이터 분석 패키지를 한 번에 설치하고 그래픽 도구까지 사용하려면 아나콘다가 편할 수 있습니다.
미니콘다에도 Jupyter Notebook을 설치할 수 있나요?
가능합니다. 원하는 환경을 활성화한 뒤 conda install jupyterlab을 실행하면 됩니다. 프로젝트마다 Jupyter 환경을 분리하고 싶다면 각 가상환경에 따로 설치하세요.
가상환경마다 파이썬 버전을 다르게 사용할 수 있나요?
가능합니다. 환경을 생성할 때 python=3.11처럼 버전을 지정하면 프로젝트별로 서로 다른 파이썬 버전을 사용할 수 있습니다.
가상환경은 어디에 저장되나요?
conda info --envs를 실행하면 환경 이름과 실제 저장 경로를 함께 확인할 수 있습니다.
마치며
미니콘다를 처음 설치했다면 복잡한 명령어를 한꺼번에 외울 필요는 없습니다. 가상환경을 만들고 활성화한 다음 필요한 패키지를 설치하는 흐름부터 익혀보세요. 환경 구성이 끝났다면 슬기로운 통계생활 프로그래밍 Track에서 R·Python·SQL 학습 순서도 함께 확인할 수 있습니다.
사용 중 막힌 명령어나 해결되지 않는 오류가 있다면 댓글로 남겨주세요. 확인해야 할 순서부터 함께 정리해드리겠습니다.
당신이 좋아할 만한 콘텐츠
by Google Adsense
