Python/Python
📦 requirements.txt로 Python 패키지 스마트하게 관리하기
당근쥬스
2025. 4. 8. 13:40
반응형
“패키지 설치, 일일이 pip install 하는 거 지겹지 않아?”
이 글에서는 requirements.txt 파일을 활용해 프로젝트 패키지를 한 번에 설치하고, 팀원들과 깔끔하게 공유하는 방법을 소개할게요.
✅ requirements.txt란?
requirements.txt는 Python 프로젝트에 필요한 패키지 목록을 저장한 텍스트 파일입니다.
이 파일 하나만 있으면, 누구나 같은 환경을 빠르게 구성할 수 있어요.
🛠️ 1. requirements.txt 생성하기
가상환경에서 패키지를 설치한 후 아래 명령어로 현재 환경의 패키지 목록을 파일로 저장합니다:
pip freeze > requirements.txt
예시:
Django==4.2.4
djangorestframework==3.14.0
requests==2.31.0
이렇게 생성된 파일을 Git에 커밋하면 팀원들과 공유도 간편!
⚙️ 2. requirements.txt로 패키지 설치하기
다른 사람이 이 파일을 받았을 때, 아래 명령어 하나로 동일한 환경을 만들 수 있습니다:
pip install -r requirements.txt
이건 모든 패키지를 정확한 버전까지 포함해서 설치하므로, 예기치 않은 버그도 줄일 수 있어요. 🙌
🧹 3. 사용하지 않는 패키지 제거?
이미지 툴 같은 개발 중에만 쓰는 패키지를 정리하고 싶다면?
1. 가상환경 초기화
2. 필요한 것만 설치
3. 다시 freeze
# 가상환경 재설정
python -m venv .venv
source .venv/bin/activate # 또는 .\.venv\Scripts\activate
pip install django requests
pip freeze > requirements.txt
🚀 실전 팁
• pip install -r requirements.txt 전에 가상환경 꼭 활성화!
• requirements-dev.txt 따로 만들어 개발 도구 (pytest, black, mypy)는 분리 관리도 좋아요.
• pip-tools 나 poetry로 dependency 관리를 더 정교하게 할 수도 있어요.
📁 예시 디렉토리 구조
myproject/
├── requirements.txt
├── requirements-dev.txt
├── manage.py
├── myapp/
│ └── ...
🔚 마무리
requirements.txt는 단순하지만 협업, 배포, 유지보수의 핵심 도구입니다.
귀찮아도 꼭 써봅시다! 프로젝트 생명이 길어집니다 🤓✨
반응형