Skip to main content
uv는 Python 설치와 의존성 관리를 빠르게 처리하는 도구입니다.

사전 준비

  • Ubuntu 24.04
  • curl 사용 가능 환경

설치 과정

1

uv 설치

curl -LsSf https://astral.sh/uv/install.sh | sh
2

셸 설정 반영

사용하는 셸에 맞춰 설정을 반영합니다.
source ~/.bashrc
zsh를 사용하면 source ~/.zshrc를 실행합니다.
3

Python 설치 및 가상환경 생성

uv python install 3.12
mkdir -p ~/dev/uv-test
cd ~/dev/uv-test
uv venv
source .venv/bin/activate

설치 확인하기

uv --version
python --version

문제 해결

  • uv: command not found: 셸 설정 파일을 다시 로드하거나 터미널을 재시작합니다.
  • 가상환경 활성화 실패: .venv/bin/activate 파일 존재 여부를 확인합니다.

설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: Docker Engine

다음 설치 단계를 이어서 진행합니다.