# Advanced Python

# Python: .venv란?

## 1. 개요

`<span class="editor-theme-code">.venv</span>`<span style="white-space: pre-wrap;">는 Python의 </span>****가상 환경(Virtual Environment)****<span style="white-space: pre-wrap;"> 을 구성하기 위해 생성되는 </span>****프로젝트 전용 디렉터리****입니다.  
<span style="white-space: pre-wrap;">Python 3.3부터 내장된 </span>`<span class="editor-theme-code">venv</span>`<span style="white-space: pre-wrap;"> 모듈을 통해 생성되며, 각 프로젝트마다 독립된 Python 실행 환경과 패키지 저장소를 제공합니다.</span>

> <span style="white-space: pre-wrap;">✅ 목적: </span>****패키지 격리****  
> → 프로젝트 간 의존성 충돌을 방지

---

## <span style="white-space: pre-wrap;">2. 왜 </span>`<span class="editor-theme-code">.venv</span>`를 사용해야 할까?

<table id="bkmrk-%ED%95%AD%EB%AA%A9%EC%A0%84%EC%97%AD-%EC%84%A4%EC%B9%98.venv-%EC%82%AC%EC%9A%A9-%EC%8B%9C%ED%8C%A8%ED%82%A4%EC%A7%80"><colgroup><col></col><col></col><col></col></colgroup><tbody><tr><th>항목

</th><th>전역 설치

</th><th>`<span class="editor-theme-code">.venv</span>`<span style="white-space: pre-wrap;"> 사용 시</span>

</th></tr><tr><td>패키지 위치

</td><td>시스템 전체 (

`<span class="editor-theme-code">site-packages</span>`

)

</td><td><span style="white-space: pre-wrap;">프로젝트 내부 </span>

`<span class="editor-theme-code">.venv/Lib</span>`

<span style="white-space: pre-wrap;"> 등</span>

</td></tr><tr><td>프로젝트 간 버전 충돌 가능성

</td><td>❌ 높음

</td><td>✅ 격리됨

</td></tr><tr><td>협업 시 재현성

</td><td>❌ 낮음

</td><td><span style="white-space: pre-wrap;">✅ </span>

`<span class="editor-theme-code">requirements.txt</span>`

로 복제 가능

</td></tr><tr><td>삭제/재생성의 유연성

</td><td>❌ 전역에 영향

</td><td>✅ 폴더 삭제로 완전 초기화 가능

</td></tr><tr><td>Git 관리

</td><td>❌ 위험

</td><td><span style="white-space: pre-wrap;">✅ </span>

`<span class="editor-theme-code">.gitignore</span>`

로 제외 가능

</td></tr></tbody></table>

<span style="white-space: pre-wrap;">📌 전역 Python 환경은 </span>****시스템 툴, 다른 프로젝트****<span style="white-space: pre-wrap;">에 영향을 줄 수 있으므로 </span>****가상 환경을 사용하는 것이 표준 개발 방식****입니다.

---

## 3. .venv 설정 및 사용법 (VS Code 기준)

---

### 3.1 가상 환경 생성

```bash
python -m venv .venv
```

- `<span class="editor-theme-code">.venv/</span>`<span style="white-space: pre-wrap;"> 폴더가 생성되며, 구조는 다음과 같음:</span>

```text
.venv/
├── Scripts/ (Windows) 또는 bin/ (Mac/Linux)
│   ├── activate
│   ├── python.exe
├── Lib/  (패키지 설치 공간)
├── pyvenv.cfg
```

---

### 3.2 가상 환경 활성화

<table id="bkmrk-os%EB%AA%85%EB%A0%B9%EC%96%B4windows.venv%5Csc"><colgroup><col></col><col></col></colgroup><tbody><tr><th>OS

</th><th>명령어

</th></tr><tr><td>Windows

</td><td>`<span class="editor-theme-code">.venv\Scripts\activate</span>`

</td></tr><tr><td>macOS/Linux

</td><td>`<span class="editor-theme-code">source .venv/bin/activate</span>`

</td></tr></tbody></table>

- <span style="white-space: pre-wrap;">활성화되면 프롬프트에 </span>`<span class="editor-theme-code">(venv)</span>`와 같이 표시됨

---

### 3.3 패키지 설치 (가상 환경 내부에서만 작동)

```bash
pip install requests
```

- <span style="white-space: pre-wrap;">설치된 패키지는 </span>****전역이 아니라 .venv 내부****에 저장됨

---

### 3.4 가상 환경 비활성화

```bash
deactivate
```

- <span style="white-space: pre-wrap;">현재 세션에서 </span>`<span class="editor-theme-code">.venv</span>`<span style="white-space: pre-wrap;"> 연결이 해제됨</span>

---

## <span style="white-space: pre-wrap;">4. VS Code에서 </span>`<span class="editor-theme-code">.venv</span>`<span style="white-space: pre-wrap;"> 자동 인식 설정</span>

---

### 4.1 Python 확장 설치

- ****단축키****<span style="white-space: pre-wrap;">: </span>`<span class="editor-theme-code">Ctrl + Shift + X</span>`<span style="white-space: pre-wrap;"> → "Python" 검색 후 설치</span>

---

### 4.2 인터프리터 직접 선택

- VSCode 하단 상태바 &gt; Python 인터프리터 클릭
- `<span class="editor-theme-code">.venv</span>`<span style="white-space: pre-wrap;"> 내부의 Python 실행 파일 선택</span>

<table id="bkmrk-os%EA%B2%BD%EB%A1%9C-%EC%98%88%EC%8B%9Cwindows.venv%5C"><colgroup><col></col><col></col></colgroup><tbody><tr><th>OS

</th><th>경로 예시

</th></tr><tr><td>Windows

</td><td>`<span class="editor-theme-code">.venv\Scripts\python.exe</span>`

</td></tr><tr><td>macOS/Linux

</td><td>`<span class="editor-theme-code">.venv/bin/python</span>`

</td></tr></tbody></table>

---

### <span style="white-space: pre-wrap;">4.3 </span>`<span class="editor-theme-code">.vscode/settings.json</span>`<span style="white-space: pre-wrap;"> 자동 설정</span>

```json
{
  "python.defaultInterpreterPath": ".venv\\Scripts\\python.exe"
}
```

<span style="white-space: pre-wrap;">→ 저장 시 </span>`<span class="editor-theme-code">.venv</span>`가 자동으로 선택됨

---

## <span style="white-space: pre-wrap;">5. </span>`<span class="editor-theme-code">requirements.txt</span>`로 패키지 목록 관리

---

### 5.1 현재 환경 저장

```bash
pip freeze > requirements.txt
```

- <span style="white-space: pre-wrap;">현재 </span>`<span class="editor-theme-code">.venv</span>`에 설치된 모든 패키지 + 버전이 저장됨

---

### 5.2 환경 재구성 (다른 PC에서 실행)

```bash
pip install -r requirements.txt
```

- ****똑같은 버전으로 환경을 재구성****<span style="white-space: pre-wrap;"> 가능 (협업 시 필수)</span>

---

## 6. Git 관리 시 주의사항

- `<span class="editor-theme-code">.venv/</span>`<span style="white-space: pre-wrap;"> 디렉터리는 </span>****절대 Git에 포함시키지 말 것****
- `<span class="editor-theme-code">.gitignore</span>`에 아래 내용 추가:

```text
.venv/
```

<span style="white-space: pre-wrap;">📌 가상 환경은 </span>****재생성 가능****한 자원이므로, 소스 코드 저장소에 올릴 필요가 없음

---

## ✅ 요약 정리

<table id="bkmrk-%ED%95%AD%EB%AA%A9%EB%82%B4%EC%9A%A9%EC%82%AC%EC%9A%A9-%EB%AA%A9%EC%A0%81%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8%EB%B3%84-%ED%8C%A8%ED%82%A4%EC%A7%80-%EB%8F%85"><colgroup><col></col><col></col></colgroup><tbody><tr><th>항목

</th><th>내용

</th></tr><tr><td>사용 목적

</td><td>프로젝트별 패키지 독립성 확보

</td></tr><tr><td>생성 명령어

</td><td>`<span class="editor-theme-code">python -m venv .venv</span>`

</td></tr><tr><td>활성화

</td><td><span style="white-space: pre-wrap;">Windows: </span>

`<span class="editor-theme-code">.\.venv\Scripts\activate</span>`

</td></tr><tr><td>비활성화

</td><td>`<span class="editor-theme-code">deactivate</span>`

</td></tr><tr><td>설치 위치

</td><td>`<span class="editor-theme-code">.venv/Lib/site-packages</span>`

<span style="white-space: pre-wrap;"> 등</span>

</td></tr><tr><td>VSCode 자동 인식

</td><td>`<span class="editor-theme-code">settings.json</span>`

<span style="white-space: pre-wrap;">에서 </span>

`<span class="editor-theme-code">"python.defaultInterpreterPath"</span>`

<span style="white-space: pre-wrap;"> 설정</span>

</td></tr><tr><td>패키지 리스트 저장

</td><td>`<span class="editor-theme-code">pip freeze > requirements.txt</span>`

</td></tr><tr><td>공유 환경 복원

</td><td>`<span class="editor-theme-code">pip install -r requirements.txt</span>`

</td></tr></tbody></table>

---