Django

Chapter 1-2 pyenv + pyenv-virtualenv 설치 및 폴더별 자동 가상환경 설정법

Chansman 2025. 4. 29. 09:55 
\\wsl.localhost\Ubuntu-22.04\home\rainsos\pycharm_study

📚 pyenv + pyenv-virtualenv 설치 및 폴더별 자동 가상환경 설정법

✨ 이 강의의 핵심 요약

  • pyenv: 여러 파이썬 버전을 설치하고 쉽게 관리할 수 있는 도구
  • pyenv-virtualenv: 프로젝트별 독립적인 가상환경을 만들어주는 플러그인
  • 📂 폴더별로 자동으로 가상환경을 활성화할 수 있어 매우 편리함
  • 🛠 쉘 설정, 파이썬 버전 설치, 가상환경 생성과 관리까지 모두 다룸

1️⃣ 🔧 파이썬 가상 환경 설치 및 설정

과정 설명

brew install pyenv pyenv 설치
brew install pyenv-virtualenv pyenv-virtualenv 설치
쉘 설정 사용 중인 쉘(bash, zsh 등)에 맞게 초기화 파일 수정

🛠 설치 과정 상세 설명

  1. 터미널을 열고 다음 명령어로 pyenv를 설치합니다.
brew install pyenv
  1. 이어서 pyenv-virtualenv를 설치합니다.
brew install pyenv-virtualenv
  1. 설치가 끝나면 구글에 'pyenv virtualenv github' 검색 후, 공식 페이지의 셋업 가이드를 따라 쉘 설정을 진행합니다.
    • bash 사용자 ➡️ .bashrc 수정
    • zsh 사용자 ➡️ .zshrc 수정
echo 'eval "$(pyenv init --path)"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.zshrc
  1. 쉘을 다시 실행하거나 터미널을 껐다 켜줍니다.

2️⃣ 🐍 파이썬 버전 설치 및 가상환경 준비

과정 설명

현재 버전 확인 pyenv versions
설치 가능한 버전 목록 보기 pyenv install --list
새 버전 설치 pyenv install 3.12.2

📥 설치 흐름 요약

  • 기본 설치된 파이썬은 3.10.5였음
  • 폴더를 새로 만들어 (ex: test-folder) 가상환경 실습을 진행
  • 최상위 폴더에서는 하지 않고, 별도 폴더 안에서 관리하는 걸 추천 ✅

3️⃣ 🐍 가상 환경 생성 및 적용하기

명령어 설명

가상환경 생성 pyenv virtualenv 3.12.2 pvenv-test
가상환경 연결 .python-version 파일 자동 생성

🔹 흐름 설명

  • 설치한 3.12.2 버전을 기반으로 "pvenv-test"라는 가상환경 생성
  • pyenv local pvenv-test 명령을 실행하면 해당 폴더에 .python-version 파일이 생김
  • 이 파일 덕분에 해당 폴더에 들어가기만 하면 자동으로 가상환경 활성화
pyenv virtualenv 3.12.2 pvenv-test
pyenv local pvenv-test

4️⃣ 🛠 가상환경 활용 예시

예시 설명

Django 설치 pip install django (pvenv-test 가상환경에서)
Flask 설치 pip install flask (다른 가상환경에서)
  • 각 폴더마다 설치된 패키지가 다를 수 있음
  • 폴더 이동만으로 가상환경 전환이 가능해 자동화 수준으로 편리함

🚀 실전 꿀팁

✅ MKD+CD 명령어(Take 명령어): Zsh에서는 take 폴더명 하면 자동으로 폴더 생성+이동

✅ 환경별 패키지 관리: 프로젝트 별로 패키지 격리 관리 가능해 충돌 방지

✅ pyenv는 초보자도 쉽게 적응 가능: Anaconda보다 가볍고, 학습曲선이 완만함

🎯 최종 정리

pyenv와 pyenv-virtualenv를 활용하면 폴더별 자동 가상환경 설정이 가능하고, 여러 파이썬 버전과 프로젝트를 완벽하게 관리할 수 있습니다.

반드시 익혀두면 개발 인생이 2배 편해집니다! 🔥