Skip to content

python_env_setup.md

Latest commit

 

History

History
159 lines (112 loc) · 4.89 KB

python_env_setup.md

File metadata and controls

159 lines (112 loc) · 4.89 KB

Mac 환경에서 Python & Conda (Miniforge) 개발환경 세팅 가이드

Mac에서 Python 개발환경을 세팅하는 방법입니다. Miniforge를 설치하면 conda와 기본 Python을 가볍게 설치할 수 있으며, 특히 Apple Silicon (M1/M2/M3 등) 환경에서 뛰어난 호환성과 성능을 보여줍니다. 기본(base) 환경은 가급적 건드리지 않고, 프로젝트마다 별도의 가상환경을 만들어 사용하는 것을 강력히 권장합니다.

1. Miniforge로 conda와 Python 설치

가벼운 conda 배포판인 Miniforge를 Homebrew를 이용해 설치하고 초기화합니다.

1-1. Homebrew 설치

(이미 설치되어 있다면 이 단계는 패스하세요)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치가 완료되었는지 확인합니다:

brew --version

1-2. Miniforge 설치

brew install miniforge

1-3. Conda 초기화 (zsh 기준)

설치가 완료되면 쉘에서 conda 명령어를 인식할 수 있도록 초기화 과정이 필요합니다.

conda init zsh
source ~/.zshrc

1-4. 설치 확인

정상적으로 작동하는지 확인합니다.

conda --version
python --version

Tip: 설치 직후 기본 형태인 base 환경에서 Python 사용이 바로 가능하지만, 프로젝트의 패키지 충돌을 방지하기 위해 가상환경을 추가로 세팅하는 것이 좋습니다.

2. Conda 가상환경 생성 및 활용

프로젝트마다 Python 버전과 패키지를 독립적으로 관리하기 위해 가상환경을 생성합니다.

2-1. 가상환경 생성

가상환경을 생성할 때는 Python 버전을 함께 명시하는 것이 좋습니다.

conda create -n my_project python=3.10
  • -n my_project: 가상환경의 이름을 my_project로 지정합니다.
  • 과정 중 Proceed ([y]/n)? 프롬프트가 나타나면 y를 누르고 엔터를 입력합니다.

2-2. 가상환경 목록 확인

conda env list

(목록 중 *가 표시된 환경이 현재 활성화된 환경입니다.)

2-3. 가상환경 활성화 및 비활성화

원하는 가상환경에 진입(활성화)하거나 빠져나올(비활성화) 때 사용합니다.

활성화:

conda activate my_project

(터미널 앞부분 프롬프트에 (my_project) 표시가 나타납니다.)

비활성화:

conda deactivate

(기본 환경으로 돌아갑니다.)

2-4. 패키지 설치

가상환경에 진입한 상태에서 필요한 라이브러리를 설치합니다. Conda 환경에서는 가급적 conda install을 우선 사용합니다.

# conda 패키지 매니저로 설치
conda install numpy pandas

# conda에 없는 패키지는 pip로 설치 가능
pip install requests

2-5. 가상환경 삭제

더 이상 사용하지 않거나, 패키지 설정이 꼬인 환경을 통째로 지울 때 사용합니다. (해당 가상환경이 비활성화된 상태에서 진행해야 안전합니다)

conda remove -n my_project --all

3. 자주 하는 실수 & 문제 해결

실수 1: conda create -n myenv 처럼 파이썬 버전을 지정하지 않은 경우

단순히 위 명령어만 실행하면 Python 자체도 설치되지 않은 빈 환경이 만들어집니다. 활성화 후 python을 입력해도 파이썬이 실행되지 않을 수 있습니다.

해결 방법:

conda activate myenv
conda install python=3.10  # 뒤늦게라도 필요 버전을 지정해 설치!

또는, 환경 꼬임을 방지하기 위해 가상환경을 완전히 삭제하고 버전을 명시하여 다시 생성하는 것을 권장합니다.

실수 2: base 기본 환경에 패키지를 무분별하게 설치하는 경우

글로벌 환경(base)에 프로젝트별 패키지들이 섞이게 되면 추후 의존성 충돌로 환경이 꼬일 확률이 높습니다. 환경을 되돌리는 것은 까다로우므로 항상 프로젝트별로 새 환경을 생성해서 분리해 사용하는 습관을 들여야 합니다.

4. 전체 프로세스 요약 & 필수 명령어 (치트시트)

새로운 프로젝트를 시작할 때의 프로세스입니다.

  1. 환경 생성: conda create -n my_project python=3.10
  2. 환경 활성화: conda activate my_project
  3. 패키지 설치: conda install numpy pandas
  4. 작업 수행: 필요한 파이썬 프로젝트 진행
  5. 환경 종료: conda deactivate 혹은 터미널 종료

[ 기타 필수 명령어 요약 ]

# 환경 설정
conda init zsh
source ~/.zshrc

# 정보 확인 
conda --version
conda env list

# 환경 관리
conda create -n [환경이름] python=[버전]
conda activate [환경이름]
conda deactivate
conda remove -n [환경이름] --all

# 패키지 관리
conda install [패키지명]
pip install [패키지명]