Python + Poetry + Jupyter Quick Setup (30분)
데이터 분석 및 파이썬 개발을 위한 효율적인 가상 환경 구축 가이드입니다.
1. 설치 순서
- Python: `pyenv` 또는 공식 홈페이지 설치 (3.10+ 권장)
- Poetry: `pipx install poetry` 또는 공식 스크립트 설치
- IDE: PyCharm 또는 VS Code (Python 확장 필수)
2. 필수 설정 3개
- In-project Virtualenv: `poetry config virtualenvs.in-project true` (IDE 연동 편리)
- Jupyter Kernel: `poetry run python -m ipykernel install --user`로 커널 등록
- Linting/Formatting: Ruff 설정 (빠른 속도와 통합 기능)
3. 흔한 에러 3개 + 해결
1) 의존성 해결 실패: `poetry lock --no-update` 후 `poetry install`
2) 터미널 가상환경 미인식: `poetry shell` 명령어로 명시적 진입
3) Jupyter 패키지 누락: `poetry add jupyter ipykernel` 확인
4. 팀 합류 체크리스트 (Day 1)
# 1. 가상환경 구축 및 패키지 설치
poetry install
# 2. 주피터 노트북 실행
poetry run jupyter notebook
# 3. 스크립트 실행 테스트
poetry run python main.py
✅ 성능 확인: 가상환경(`.venv`) 폴더 생성 여부 및 커널 작동 확인