Skip to main content

uv + Python 설정

uv는 Python 설치와 가상환경 생성을 빠르게 처리하는 도구입니다.

사전 준비

  • Homebrew 설치 완료
  • 터미널 사용 가능 상태

설치 과정

1

uv 설치

아래 명령어를 실행하세요.
curl -LsSf https://astral.sh/uv/install.sh | sh
2

셸 설정 반영

설치 후 현재 셸 설정을 다시 불러옵니다.
source ~/.zshrc
3

Python 설치 및 가상환경 생성

예시로 Python 3.12와 테스트 가상환경을 만듭니다.
uv python install 3.12
mkdir -p ~/dev/uv-test
cd ~/dev/uv-test
uv venv
source .venv/bin/activate

설치 확인하기

uv --version
python --version
가상환경이 활성화된 상태에서 Python 버전이 출력되면 정상입니다.

문제 해결

  • uv: command not found: source ~/.zshrc를 다시 실행하거나 터미널을 재시작하세요.
  • 가상환경 활성화 실패: 현재 폴더에 .venv가 생성됐는지 확인하세요.