Chapter 1-2 Windows에서 pyenv + 가상환경 설정법 (Mac 과정 대응 버전)

📚 Windows에서 pyenv + 가상환경 설정법 (Mac 과정 대응 버전)

---

0️⃣ 📦 준비물 확인

• Git 설치 → 다운로드 링크
• PowerShell 관리자 실행 가능 여부
• Python은 pyenv로 설치할 예정 (Windows에 기본 설치된 건 무시)

---

1️⃣ 🔧 pyenv-win 설치 및 초기 설정

🛠 과정 설명

Mac에서 brew install 한 것을 Windows에서는 이렇게 바꿔야 합니다.

Mac 명령어 Windows 대체 방법

brew install pyenv

Git으로 pyenv-win 설치

🏗 설치 과정 상세

PowerShell(관리자 권한) 실행 후:

# pyenv-win 설치
git clone https://github.com/pyenv-win/pyenv-win.git $env:USERPROFILE\.pyenv

환경 변수 설정:

# 환경 변수 추가
[Environment]::SetEnvironmentVariable('PYENV', "$env:USERPROFILE\.pyenv", 'User')
[Environment]::SetEnvironmentVariable('Path', "$env:USERPROFILE\.pyenv\pyenv-win\bin;$env:USERPROFILE\.pyenv\pyenv-win\shims;$env:Path", 'User')

✅ 포인트

• .zshrc, .bashrc 수정 필요 없음
• PowerShell 다시 시작 (필수)
• pyenv, pyenv virtualenv 기본 내장

---

2️⃣ 🐍 Python 버전 설치 및 가상환경 준비

🛠 과정 설명

Mac에서 버전 설치하는 것을 Windows에서는 이렇게 합니다.

Mac 명령어 Windows 명령어

pyenv install 3.13.2

pyenv install 3.13.2

PowerShell에서 실행:

# 설치 가능한 Python 버전 확인
pyenv install --list

# 원하는 버전 설치
pyenv install 3.13.2

✅ 설치한 버전 확인:

pyenv versions

---

3️⃣ 🐍 가상환경 생성 및 적용하기

🛠 과정 설명

Mac에서는 pyenv-virtualenv로 만들지만, Windows에서는 바로 pyenv 명령어로!

Mac 명령어 Windows 명령어

pyenv virtualenv 3.12.2 pvenv-test

pyenv virtualenv 3.12.2 pvenv-test

 

폴더를 하나 만든 후 (예: myproject ), 해당 폴더로 이동해서:

mkdir myproject
cd myproject

 

해당 폴더에서 가상환경 연결

pyenv local 3.13.2

ls -Force # 리눅스의 ls -al

cat .python-version # ( vi .python-version 리눅스 )
notepad .python-version # ( 수정하고싶을때 )

# 만약 정말 Linux처럼 vi, nano 같은 편집기를 쓰고 싶으면,

Windows에 WSL(Windows Subsystem for Linux) 을 설치하거나,

Git Bash 설치하면 가능해.

→ .python-version 파일이 생성되고, 해당 폴더에 들어가기만 하면 가상환경이 자동 활성화됩니다! 🔥

 

Python 가상환경 생성:

pyenv virtualenv 3.13.2 pvenv-test 

# ✅ Windows용 pyenv (pyenv-win) 에는
pyenv virtualenv 명령어 자체가 없다.

pyenv-win은 Mac/Linux의 pyenv + pyenv-virtualenv 구조와 다르게 설계되어 있어.
→ 가상환경을 따로 pyenv virtualenv 명령으로 만들지 않고,
→ 그냥 Python 버전만 설치하고, 프로젝트 폴더에서 바로 local로 연결하는 방식이야.

✅ 그래서 Windows에서는 pyenv virtualenv를 사용할 수 없다. (에러가 정상)

 

 

→ .python-version 파일이 생성되고, 해당 폴더에 들어가기만 하면 가상환경이 자동 활성화됩니다! 🔥

 

✅ 확인:

python --version

---

4️⃣ 🛠 가상환경 활용 예시

🎯 예시

• Django 설치

pip install django

• Flask 설치 (다른 가상환경에서)

pip install flask

✅ 주의:

• 각 폴더에 다른 가상환경을 연결했기 때문에, 설치된 패키지가 서로 다릅니다.
• 폴더 이동만으로 가상환경 전환이 자동으로 됩니다!

---

🚀 실전 꿀팁 모음

항목 내용

mkdir + cd	Windows에서는 mkdir 폴더명; cd 폴더명 사용
프로젝트별 패키지 관리	패키지 충돌 방지
Anaconda보다 가벼움	초보자도 쉽게 적응 가능
.python-version	폴더 이동 시 자동 가상환경 전환 핵심

---

🎯 최종 정리

✅ Windows에서도 pyenv + virtualenv 조합으로 ✅ 폴더별 자동 가상환경 설정 가능 ✅ 여러 Python 버전과 프로젝트를 완벽하게 관리할 수 있습니다.

💯 이 과정 한 번 설치해두면 개발 인생이 2배 이상 편해집니다! 🔥

 

 

📚 pyenv Windows 설치 방법 총정리 (pyenv-win)

---

✨ 이 강의의 핵심 요약

• pyenv는 여러 버전의 Python을 설치하고 관리하는 도구입니다.
• Windows에서는 pyenv-win이라는 별도 버전을 설치해야 합니다.
• Python 개발을 효율적으로 하기 위해 버전 충돌 없이 프로젝트별 관리가 가능합니다.

---

1️⃣ 🎯 pyenv-win 설치 개요

항목설명

설치 대상	Windows 10 이상 운영체제 사용자
공식 레포	https://github.com/pyenv-win/pyenv-win
주요 기능	여러 Python 버전 설치/삭제/전환 가능
설치 방법	Powershell 또는 명령 프롬프트(cmd) 이용

---

2️⃣ 🛠️ pyenv-win 설치 준비

✅ 설치 전 사전 준비사항 체크리스트

• Windows 버전 확인 (Windows 10 이상 권장)
• Git 설치 (필수)
  → Git for Windows 다운로드
• 환경변수 편집 준비 (Path 설정 필요)

---

3️⃣ 🚀 pyenv-win 설치 방법

1단계. Git Bash 또는 Powershell 열기

• 관리자 권한으로 열어야 권한 문제 없이 진행할 수 있어요! ⚡

2단계. pyenv-win 설치하기

git clone https://github.com/pyenv-win/pyenv-win.git %USERPROFILE%\\.pyenv

• 사용자 홈 디렉토리(%USERPROFILE%)에 .pyenv 폴더가 생성됩니다.

3단계. 환경변수 설정하기

🔹 아래 세 가지 경로를 시스템 환경 변수 Path에 추가합니다.

%USERPROFILE%\.pyenv\pyenv-win\bin
%USERPROFILE%\.pyenv\pyenv-win\shims
%USERPROFILE%\.pyenv\pyenv-win

• Windows 검색 → "환경 변수 편집" → "Path" 항목 편집 → 위 3개 경로 추가

4단계. 설치 확인

• 새 터미널 열고 다음 명령어 입력:

pyenv --version

• pyenv 버전이 정상 출력되면 설치 완료! 🎉

---

4️⃣ 🐍 pyenv-win 사용 방법 기본

✅ Python 설치가능 버전 확인

pyenv install --list

pyenv install 3.12 #하고 텝누르면 설치가능버전나옴

✅ Python 버전 설치

pyenv install 3.13.2

✅ 설치된 버전 목록 확인

pyenv versions

✅ 글로벌(기본) 버전 설정

pyenv global 3.13.2

 

-----------------------------------------------------------------------------------------------------------------------------------------------------------------

 

이후 폴더 만들어서 가상환경에 설치가능

 

✅ 로컬(폴더별) 버전 설정

pyenv local 3.13.2

✅ Python 버전 삭제

pyenv uninstall 3.13.2

 

---

5️⃣ ⚡ pyenv-win 설치/사용 시 주의사항

주의사항설명

Git 미설치 오류	반드시 Git for Windows 설치 후 진행
관리자 권한	터미널은 관리자 권한으로 실행 추천
환경변수 설정 실수	3개 경로 정확히 추가해야 정상 작동
설치 후 재부팅	환경변수 적용 위해 재부팅하는 게 가장 안전

---

🚀 최종 요약

• Windows에서는 pyenv-win을 설치해야 Python 버전을 자유롭게 관리할 수 있습니다.
• Git 설치 → pyenv 설치 → 환경변수 추가 → 설치 확인 4단계만 기억하면 쉽게 완료할 수 있습니다.
• 여러 프로젝트에서 서로 다른 Python 버전이 필요할 때 필수 도구입니다! 🐍

이제 Python 버전 관리, pyenv로 완벽하게 시작하세요! 🔥