파이썬(Python) 환경 설정 완벽 정리 (Windows 기준)

안녕하세요

파이썬에 대해 공부해 보려고 합니다. 같이 한 번 시작해 볼까요?

 

1. 파이썬 설치

1. 공식 사이트 접속:  https://www.python.org/downloads/
2. Windows용 최신 Python 3.x 다운로드
3. 설치 시 Add Python to PATH 반드시 체크 
4. 설치 확인:

c:\workspace>python --version Python 3.13.7

 

2. 프로젝트별 가상환경 만들기

전역(Global) 환경에 설치하면 패키지 충돌이 날 수 있으므로, 프로젝트별로 가상환경(Virtual Environment)을 만들어야 합니다.

예: ProjectA라는 프로젝트

# ProjectA 폴더로 이동 C:\workspace\ProjectA> python -m venv venv_ProjectA # 가상환경 활성화 C:\workspace\ProjectA> .\venv_ProjectA\Scripts\Activate (venv_ProjectA) C:\workspace\ProjectA>

☞ 프롬프트 앞에 (venv_ProjectA)가 붙으면 성공입니다.

 

비활성화:

(venv_ProjectA) C:\workspace\ProjectA> deactivate

 

3. 패키지 설치 & 관리

가상환경 활성화 상태에서만 패키지를 설치해야 합니다.

예시: requests 설치

(venv_ProjectA) C:\workspace\ProjectA> pip install requests

 

설치된 패키지 확인:

(venv_ProjectA) C:\workspace\ProjectA> pip list Package            Version ------------------ -------- certifi            2025.8.3 charset-normalizer 3.4.3 idna               3.10 pip                25.2 requests           2.32.5 urllib3            2.5.0

 

4. 환경 저장 & 공유 (requirements.txt)

(1) 현재 환경 저장

(venv_ProjectA) C:\workspace\ProjectA> pip freeze > requirements.txt

 

(2) 다른 프로젝트에서 동일하게 설치

예: ProjectB에서 동일 환경 구성

# ProjectB 폴더에서 가상환경 생성 C:\workspace\ProjectB> python -m venv venv_ProjectB C:\workspace\ProjectB> .\venv_ProjectB\Scripts\Activate (venv_ProjectB) C:\workspace\ProjectB> # ProjectA에서 만든 requirements.txt 복사 후 실행 (venv_ProjectB) C:\workspace\ProjectB> pip install -r requirements.txt (venv_ProjectB) C:\workspace\ProjectB> pip list Package            Version ------------------ -------- certifi            2025.8.3 charset-normalizer 3.4.3 idna               3.10 pip                25.2 requests           2.32.5 urllib3            2.5.0

☞  이제 ProjectB도 ProjectA와 동일한 환경을 가짐

 

5. 환경 관리 팁

• 가상환경 폴더 이름을 프로젝트별로 다르게 (venv_ProjectA, venv_ProjectB)
• 협업 시에는 requirements.txt만 공유, 가상환경 폴더는 Git에 업로드하지 않음
• 필요 시 패키지 업그레이드:

(venv_ProjectA) C:\workspace\ProjectA> pip install --upgrade requests

 

• 패키지 삭제:

(venv_ProjectA) C:\workspace\ProjectA> pip uninstall requests

 

■ 정리

• 파이썬 설치 시 PATH 추가 꼭 체크
• 프로젝트마다 별도의 가상환경 생성
• 패키지는 항상 (venv_프로젝트명) 표시가 있는 상태에서 설치
• requirements.txt로 환경을 저장하고 공유

☞  이제 환경 설정이 끝났습니다.

 

감사합니다.