📦Python 가상환경(venv) 사용법 + `requirements.txt` 완전정복

팀 프로젝트를 하거나 외부에 배포할 때, 파이썬 가상환경 설정과 패키지 관리는 필수입니다.
이번 포스팅에서는 venv로 가상환경을 만들고, requirements.txt로 패키지를 관리하는 법을 기초부터 실전 예제까지 정리해보겠습니다. ✅

---

🎯 1. 가상환경이란? 왜 필요한가요?

파이썬은 전역(Global) 환경에 패키지를 설치하면 모든 프로젝트에서 섞여서 충돌할 수 있습니다.

📌 가상환경은 프로젝트마다 독립된 패키지 공간을 만들어주는 "격리된 공간"입니다.

예를 들어,

• 프로젝트 A는 pandas==1.3
• 프로젝트 B는 pandas==2.2

을 쓸 때 서로 영향을 주지 않도록 해주는 게 바로 venv입니다!

---

🛠️ 2. 가상환경 만들기 (venv 사용)

✅ 가상환경 생성

python -m venv venv

• venv라는 폴더가 생성되며, 그 안에 독립적인 파이썬 환경이 만들어집니다.

✅ 가상환경 활성화

• Windows:

  venv\Scripts\activate

• Mac/Linux:

  source venv/bin/activate

활성화되면 터미널 앞에 (venv) 표시가 생깁니다.

---

🧪 3. 가상환경 안에서 패키지 설치

이제 pip install로 패키지를 설치하면 로컬 가상환경에만 적용됩니다.

pip install pandas requests

---

🗂 4. requirements.txt로 패키지 목록 저장

가상환경 안에서 설치된 패키지 리스트를 저장하려면 아래 명령어 사용:

pip freeze > requirements.txt

생성된 requirements.txt는 예를 들어 아래처럼 나옵니다:

pandas==2.2.1
requests==2.31.0

---

🚚 5. 다른 환경에서 requirements.txt로 재설치하기

협업자나 서버에서 동일한 환경을 구성할 때:

pip install -r requirements.txt

🎯 모든 패키지와 버전이 자동으로 설치되어 같은 환경을 복제할 수 있습니다.

---

🧹 6. 가상환경 비활성화

가상환경에서 나가려면:

deactivate

---

🛠 실전 예제: 프로젝트 세팅 순서

# 1. 가상환경 생성
python -m venv venv

# 2. 가상환경 활성화
source venv/bin/activate  # 또는 venv\Scripts\activate (Windows)

# 3. 필요한 패키지 설치
pip install pandas requests openpyxl

# 4. 패키지 목록 저장
pip freeze > requirements.txt

# 5. (다른 PC에서 복원 시)
pip install -r requirements.txt

---

🧠 마무리 요약

작업	명령어
가상환경 생성	python -m venv venv
가상환경 실행	source venv/bin/activate or venv\Scripts\activate
패키지 설치	pip install 패키지명
목록 저장	pip freeze > requirements.txt
목록으로 설치	pip install -r requirements.txt
가상환경 종료	deactivate

✅ 프로젝트별로 가상환경을 쓰면 패키지 충돌 없이 안정적인 개발과 협업이 가능합니다!

---