Python/Python

📦 requirements.txt로 Python 패키지 스마트하게 관리하기

당근쥬스 2025. 4. 8. 13:40
반응형
“패키지 설치, 일일이 pip install 하는 거 지겹지 않아?”
이 글에서는 requirements.txt 파일을 활용해 프로젝트 패키지를 한 번에 설치하고, 팀원들과 깔끔하게 공유하는 방법을 소개할게요.

✅ requirements.txt란?

 

requirements.txtPython 프로젝트에 필요한 패키지 목록을 저장한 텍스트 파일입니다.

이 파일 하나만 있으면, 누구나 같은 환경을 빠르게 구성할 수 있어요.


🛠️ 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-toolspoetry로 dependency 관리를 더 정교하게 할 수도 있어요.


📁 예시 디렉토리 구조

myproject/
├── requirements.txt
├── requirements-dev.txt
├── manage.py
├── myapp/
│   └── ...

🔚 마무리

 

requirements.txt는 단순하지만 협업, 배포, 유지보수의 핵심 도구입니다.

귀찮아도 꼭 써봅시다! 프로젝트 생명이 길어집니다 🤓✨

반응형