Python - Anaconda 환경 설치 및 설정 가이드

1. 개요

Anaconda는 과학 계산, 데이터 분석, 인공지능 등 다양한 분야에 활용되는 파이썬 배포판입니다. 주로 리눅스, 맥, 윈도우에서 사용 가능하며, 파이썬과 함께 수많은 유용한 라이브러리 및 도구를 포함하고 있습니다.

Conda란?

패키지와 의존성, 환경을 관리하는 도구입니다.

  • 패키지 관리: pip와 유사하지만, 파이썬 외에도 다양한 언어의 패키지를 지원합니다.
  • 환경 관리: 여러 버전의 파이썬을 쉽게 생성하고 전환할 수 있으며, 격리된 가상 환경을 구축할 수 있습니다.
  • 자세한 문서: conda 문서

Anaconda란?

Conda, 특정 버전의 파이썬, 수많은 과학 계산용 라이브러리 등을 미리 패키지화하여 제공하는 종합적인 파이썬 배포판입니다. 공간이 다소 큽니다.

Miniconda란?

최소한의 구성(파이썬, Conda)만 포함된 경량 도구입니다. 디스크 용량이 제한된 환경에 적합합니다.

2. 설치

주의: 본 문서는 주로 Windows 시스템을 기준으로 설명됩니다.

다운로드 링크

설치 절차

  1. 다운로드 후 설치 프로그램 실행
  2. 설치 경로를 명시적으로 지정 (기본 경로 대신 원하는 위치 선택)
  3. 다음 애플리케이션 설치됨:
    • Anaconda Navigator: GUI 기반 패키지 및 환경 관리
    • Anaconda Prompt: 커맨드라인에서 conda 명령어 실행
    • Jupyter Notebook: 웹 기반 코드 실행 및 문서 작성
    • Spyder: 과학 계산용 통합 개발 환경
    • JupyterLab: 보다 발전된 웹 기반 작업 환경
    • Qt Console: IPython 기반 그래픽 콘솔
    • Glueviz: 데이터 시각화 및 탐색 도구
    • Orange3: 시각적 데이터 분석 툴
    • VS Code: 확장성 뛰어난 코드 편집기

경로 변수 설정

명령줄에서 `conda` 명령어가 인식되지 않는 경우, 다음 경로를 시스템 환경 변수에 추가하세요:

D:\DownLoadFiles\anaconda3\Scripts

도움말 확인

터미널에서 아래 명령어로 도움말 확인 가능:

conda -h
conda <명령어> -h

3. 국내 반영 서버 및 프록시 설정

서버 접근 속도를 높이기 위해 국내 반영 서버를 사용하는 것이 좋습니다.

반영 서버 추가

conda config --add channels 'https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/'
conda config --add channels 'https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/'
conda config --set show_channel_urls yes

설정 확인

conda config --show
conda config --show-sources

수동 설정 파일 수정

`.condarc` 파일을 직접 수정하여 다음과 같이 설정할 수 있습니다:

channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
  - defaults
show_channel_urls: True

4. 환경 및 캐시 저장 경로 변경

기본적으로 환경과 패키지 캐시는 사용자 홈 디렉토리에 저장됩니다. 이를 다른 디렉토리로 이동하려면 다음과 같이 설정합니다.

`.condarc` 파일에 추가

envs_dirs:
  - D:\DownLoadFiles\anaconda3\envs
  - C:\Users\guowli\AppData\Local\conda\conda\envs
pkgs_dirs:
  - D:\DownLoadFiles\anaconda3\pkgs
  - C:\Users\guowli\AppData\Local\conda\conda\pkgs

명령어로 설정

conda config --add envs_dirs "D:\DownLoadFiles\anaconda3\envs"
conda config --add pkgs_dirs "D:\DownLoadFiles\anaconda3\pkgs"

5. 패키지 관리

모든 패키지 업데이트

conda update --all

주요 명령어

  • conda install <package_name>: 패키지 설치
  • conda install numpy=1.10: 특정 버전 설치
  • conda remove <package_name>: 제거
  • conda list: 설치된 패키지 목록 보기
  • conda search <term>: 패키지 검색
  • conda install --name testpy2 pandas: 특정 환경에 설치
  • conda update conda: conda 자체 업데이트

pip를 통한 패키지 설치 (Conda 미지원 시)

Conda에서 찾을 수 없는 패키지는 `pip`로 설치 가능합니다. 먼저 환경 활성화 후 설치:

conda activate <env_name>
pip install <package_name> --proxy http://proxy.example.com:8080

6. 가상 환경 관리

주요 명령어

conda create --name myenv python=3.9
conda env list
activate myenv
deactivate
conda env remove --name myenv

환경 공유

다른 사용자가 동일한 환경을 재현하도록 하기 위해 현재 환경 정보를 내보냅니다.

conda env export > environment.yaml
conda env create --force -f environment.yaml

7. PyCharm에서 Conda 환경 사용

  1. Anaconda Prompt에서 conda env list로 환경 경로 확인
  2. PyCharm → File → Settings → Project → Python Interpreter → Add → Local → 경로 지정
  3. 설정된 환경 선택 후 적용

8. 문제 해결

경고 메시지: conda.compat module is deprecated

해당 경고는 Conda 4.6.11 버그로 발생. 최신 버전으로 업데이트하면 해결됩니다.

conda update conda

HTTP 연결 실패: CondaHTTPError: HTTP 000 CONNECTION FAILED

HTTPS 문제로 인해 발생할 수 있음. `.condarc` 파일에서 모든 `https`를 `http`로 변경하거나, 프록시 설정 확인.

channels:
  - http://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - http://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
ssl_verify: false

설정 후 캐시 정리:

conda clean -i

SSL 인증 오류: CERTIFICATE_VERIFY_FAILED

국내 네트워크 환경에서 발생. 안전한 호스트로 설정하거나 반영 서버 사용:

pip install jenkinsapi --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org

태그: conda Anaconda python virtual environment package management

7월 18일 18:44에 게시됨