[Python] pyenv(파이썬 버전 관리), venv(파이썬 가상환경 관리)

🐍 1. 파이썬 패키지란?

• 파이썬 패키지는 특정 기능을 제공하는 코드 모음(모듈과 라이브러리).
• pip(Python Package Installer)를 사용해 패키지를 설치하고 관리.
• 예시: pip install requests → requests 라이브러리를 설치.

---

🛠 2. 패키지 관리 및 가상환경 도구

1️⃣ pyenv (파이썬 버전 관리)

• 여러 개의 파이썬 버전을 설치하고 전환하는 도구.
• 시스템 기본 파이썬을 변경하지 않고 특정 버전을 프로젝트별로 설정 가능.
• 윈도우: pyenv-win 사용 (GitHub)
• 맥: brew install pyenv로 설치 가능.

✅ 주요 명령어

# pyenv 설치 (맥)
brew install pyenv

# pyenv 설치 (윈도우)
git clone https://github.com/pyenv-win/pyenv-win.git ~/.pyenv

# 설치 가능한 파이썬 버전 목록 확인
pyenv install --list  
# 특정 버전의 파이썬 설치
pyenv install 3.12.3

# 설치된 파이썬 버전, 현재 활성화된 파이썬 버전 확인
pyenv versions

# 특정 폴더에서 파이썬 버전 지정
pyenv local 3.11.9

# 전역 파이썬 버전 설정. 기본 파이썬 버전을 3.12.3으로 설정
pyenv global 3.12.3

---

2️⃣ venv (가상환경 생성 및 관리)

• 프로젝트마다 독립적인 패키지 환경을 제공하는 파이썬 내장 모듈.
• 하나의 시스템에서 여러 프로젝트가 서로 다른 패키지 버전을 사용할 수 있도록 지원.

✅ 가상환경 생성 및 활성화

가상환경 생성 시 .venv처럼 "."으로 시작하는 이유?

• "."으로 시작하면 숨김 파일/폴더로 인식됨.
  → 터미널에서 ls -la를 사용해야 보임(맥/리눅스 기준).
• 가상환경 폴더를 깔끔하게 숨기기 위해 자주 사용됨.
  → .venv를 사용하면 프로젝트 폴더 내에서 깔끔하게 관리 가능.
• IDE(예: VSCode)에서 자동 인식이 쉬움.
  → VSCode는 .venv 폴더가 있으면 자동으로 해당 환경을 감지하고 설정.

하지만 .venv가 필수는 아님!

아래와 같이 폴더명을 자유롭게 지정 가능:

# 가상환경 생성 (윈도우 & 맥)
python -m venv .venv  # ".venv" 폴더 생성 (숨김폴더)
python -m venv myenv  # "myenv" 폴더 생성 (숨김 아님)

# 가상환경 활성화
# 윈도우 (cmd)
.venv\Scripts\activate

# 윈도우 (PowerShell)
.venv\Scripts\Activate.ps1

# 맥 / 리눅스
source .venv/bin/activate

# 가상환경 비활성화 (윈도우 & 맥 동일)
deactivate

---

3️⃣ pip로 패키지 설치 및 관리

• requirements.txt 파일을 사용하면 프로젝트에 필요한 패키지 목록을 기록하고 공유 가능.
• 가상환경에서 패키지를 설치하고 requirements.txt로 관리하면 협업이나 배포 시 유용.

✅ 패키지 목록 저장 & 설치. requirements.txt (패키지 의존성 관리)

# 현재 환경에서 설치된 패키지 확인
pip list

# 패키지 설치
# pip install 패키지명
pip install pandas

# 특정 버전의 패키지 설치
# pip install 패키지명==버전번호
pip install requests==2.26.0  # requests 패키지 2.26.0 버전 설치

# 패키지 최신 버전으로 업데이트
# pip install --upgrade 패키지명
pip install --upgrade requests
# 현재 가상환경에서 설치된 패키지 목록 저장
pip freeze > requirements.txt

# requirements.txt 기반으로 패키지 일괄 설치
pip install -r requirements.txt

---

🔎 3. 설치한 패키지는 해당 가상환경에서 실행해야 한다!

왜 가상환경을 사용해야 할까?

• pip install로 패키지를 설치하면 기본적으로 현재 활성화된 환경에 설치됨.
• 가상환경을 활성화한 후 패키지를 설치하면 해당 가상환경에서만 적용됨.
• 즉, 특정 가상환경을 활성화하지 않고 실행하면, 원하는 패키지가 없을 수 있음.

✅ 설치한 패키지 위치 확인

# 현재 활성화된 파이썬이 어디에 있는지 확인
which python  # 맥/Linux
where python  # 윈도우

# 설치된 패키지 목록 확인
pip list

⚠️ 주의할 점

• 가상환경을 활성화한 상태에서 패키지를 설치해야 해당 프로젝트에서 사용할 수 있음.
• 시스템 전체에 영향을 주지 않으려면 항상 venv 또는 pyenv 등을 활용하는 것이 좋음.

---

💡 정리

• pyenv → 파이썬 버전 관리 도구 (여러 버전의 파이썬을 쉽게 전환)
• venv → 프로젝트별 가상환경 관리 도구
• pip → 파이썬 패키지 관리 도구
• requirements.txt → 패키지 목록을 저장하고 공유하는 파일

즉, 프로젝트를 할 때는:

1. pyenv를 사용해 적절한 파이썬 버전 설정 (필요한 경우)
2. venv로 가상환경을 생성하고 활성화
3. pip install로 필요한 패키지를 설치
4. requirements.txt로 패키지를 관리

이런 순서로 하면 안정적인 개발 환경을 유지할 수 있어! 🚀

🎯 최적의 프로젝트 세팅 예시

# 1. pyenv로 필요한 파이썬 버전 설치 (선택 사항)
pyenv install 3.10.6
pyenv global 3.10.6  # 기본 파이썬 버전 설정

# 2. 프로젝트 폴더에서 가상환경 생성
python -m venv .venv

# 3. 가상환경 활성화
source .venv/bin/activate  # (맥/Linux)
.venv\Scripts\activate     # (윈도우 CMD)

# 4. 필요한 패키지 설치
pip install requests==2.26.0

# 5. 패키지 목록 저장
pip freeze > requirements.txt

# 6. (협업 시) 패키지 설치
pip install -r requirements.txt