Table of Contents
requirements.txt 설치 방법: 파이썬 프로젝트 패키지 한 번에 세팅하기
깃허브에서 파이썬 프로젝트를 내려받았는데 바로 실행이 안 된다면, 대부분은 필요한 패키지가 아직 설치되지 않았기 때문입니다. 이때 가장 자주 보는 파일이 requirements.txt입니다. 이 글에서는 requirements.txt가 무엇인지와 설치 방법을 정리합니다.
requirements.txt란 무엇인가
프로젝트에 필요한 파이썬 패키지 목록을 적어 둔 파일입니다. 이 파일이 있으면 다른 사람도 같은 패키지 구성을 비교적 쉽게 맞출 수 있습니다.
설치 명령어
python -m pip install -r requirements.txt환경에 따라 아래처럼 실행할 수도 있습니다.
python3 -m pip install -r requirements.txt설치 전에 먼저 할 일
가능하면 전역 환경이 아니라 가상환경을 먼저 만들고 활성화한 뒤 설치하는 것이 좋습니다.
python -m venv .venv관련 글:
설치가 안 될 때 확인할 것
1. 현재 pip가 다른 파이썬을 보고 있는 경우
python -m pip --version현재 프로젝트에서 쓰는 파이썬과 pip가 같은 환경인지 먼저 확인합니다.
2. requirements.txt 파일 위치가 다른 경우
터미널 현재 경로에 파일이 없으면 설치가 실패합니다. 먼저 파일이 있는 폴더로 이동합니다.
3. 특정 패키지 버전 충돌이 있는 경우
오래된 프로젝트는 지금 환경과 버전이 안 맞을 수 있습니다. 오류 메시지에 나온 패키지 이름과 버전을 먼저 확인해야 합니다.
설치 후 확인
python -m pip list필요한 패키지가 들어왔는지 목록으로 확인합니다.
함께 보면 좋은 글
정리
requirements.txt는 프로젝트 패키지 목록 파일python -m pip install -r requirements.txt가 기본 명령어- 가상환경 안에서 설치하는 것이 가장 안전함
- 설치 전후로 현재 pip 환경을 같이 확인해야 함