Python 가상환경에서 uv 설치하기 - 3단계 완벽 가이드

 

macOS에서 pip install uv 실행 시 externally-managed-environment 오류가 발생한다면? 가상환경을 사용하면 간단히 해결됩니다! 🐍

🚀 3단계로 끝내는 uv 설치

1단계: 가상환경 생성

# 프로젝트 폴더로 이동 후
python3 -m venv venv

실행하면 venv 폴더가 생성되고, 안에는 이런 파일들이 만들어집니다:

 

 

venv/
├── bin/          # 실행 파일들
├── include/      # 헤더 파일
├── lib/          # 패키지들이 설치될 곳
└── pyvenv.cfg    # 가상환경 설정

2단계: 가상환경 활성화

source venv/bin/activate

성공하면 터미널 앞에 (venv)가 표시됩니다:

 

 

3단계: uv 안전하게 설치

pip install uv

이제 오류 없이 깔끔하게 설치됩니다! ✅

💡 추가 팁

설치 확인

uv --version

가상환경 종료

deactivate

다시 사용하려면

source venv/bin/activate

🤔 왜 가상환경을 써야 할까?

• 안전함: 시스템 Python을 건드리지 않음
• 깔끔함: 프로젝트별로 패키지 관리
• 편리함: 언제든 삭제하고 다시 만들 수 있음

⚠️ 주의사항

• 가상환경을 활성화한 상태에서만 uv 사용 가능
• 프로젝트 작업 시 항상 source venv/bin/activate 먼저 실행
• .gitignore에 venv/ 추가하는 것을 잊지 마세요!

---

간단하죠? 이제 Python 패키지 설치 오류 때문에 고민할 필요 없습니다! 🎉

 

#Python #가상환경 #uv #pip #개발환경 #macOS #터미널 #패키지관리 #개발팁 #프로그래밍