파이썬 압축파일로 관리 /w requirements.txt

목표

핵심 목표

• requirements.txt 사용방법 
• 파이썬 프로젝트 공유 대상 구분

 

실습 과정

1. 기존 PyCharm 프로젝트(도서관리 시스템)를 안전하게 압축해서 전달/보관 가능하게 만들기
2. 새 폴더로 이동해서 압축을 풀고 PyCharm에서 “새 프로젝트”처럼 열기
3. 새 venv를 만들고 패키지를 재설치하여 “다른 PC에서도 바로 실행”되게 만들기
4. 실행 확인

 

1. 압축 

(1) 압축 파일 제외할 것

 

1. 가상환경 폴더(venv, .venv)
   • 이유: 용량이 크고 OS/PC마다 다르며, 압축으로 옮기면 거의 항상 문제가 납니다.
     
     
2. PyCharm 설정 폴더(.idea)
   • 이유: 사용자 PC별 경로/인터프리터/캐시 설정이 포함되어 충돌할 수 있습니다.
   • 다만 교육용으로 “동일 환경”을 강제해야 하면 포함하는 경우도 있으나, 일반적으로 제외 권장입니다.
     
     
3. 캐시/빌드/임시 파일
   • pycache 폴더
   • *.pyc 파일
   • .pytest_cache 등
     
     
4. 민감정보
   • DB 비밀번호가 들어간 config.py
   • 실제 배포/공유 시에는 분리 권장(.env 등)

 

 

(2) requirements.txt 생성

 

1. PyCharm 터미널에서 아래를 실행합니다.

pip freeze > requirements.txt

 

2. 생성 확인
프로젝트 루트(= main.py가 있는 위치)에 requirements.txt 파일이 생성되어야 합니다.

 

*주의
가상환경이 활성화된 상태에서 실행해야 합니다.
(즉, 현재 PyCharm이 사용 중인 인터프리터가 venv라면 그대로 진행하면 됩니다.)

 

 

 

(3) 압축

 

필요한 파일들만 압축하여 사용합니다.

 

2. 압축 해제 후 사용

(1) PyCharm에서 새 프로젝트로 열기

1. PyCharm 실행
2. Open(열기) 선택
3. 압축 해제된 폴더 중 main.py가 들어있는 루트 폴더 선택
4. Open 클릭
5. PyCharm이 프로젝트를 인덱싱(로딩)

 

 

(2) 새 가상환경(venv) 만들기

1. 이미 가상환경이 있다면 생략한다.
2. Settings(설정) 열기
3. Project: (프로젝트명) → Python Interpreter 이동
4. Add Interpreter 또는 “톱니바퀴” 메뉴 → Add
5. Virtualenv Environment 선택
6. New environment 선택
7. Location 확인
   권장: 프로젝트 폴더 내부에 .venv 생성
   예: NewWorkspace/libraryManagementSystem/.venv
8. Base interpreter 선택
   예: Python 3.10 / 3.11 등 설치된 Python 선택
9. Create 클릭

 

 

(3) requirements.txt 기반으로 패키지 설치

 

PyCharm 하단 Terminal을 열고 아래 실행

pip install -r requirements.txt

 

기존에 설치된 패키지가 다음과 같다면

PySide6
mysql-connector-python

 

확인 명령을 통해 기존 패키지가 정상적으로 설치되었는지 확인합니다.

pip show PySide6
pip show mysql-connector-python