VS Code에서 'uv' 마스터하기: 초고속 파이썬 설정 가이드

Source: Dev.to

“uv”란 무엇인가요?

Astral(​Ruff​를 만든 팀)에서 개발하고 Rust로 작성된 uv는 매우 빠른 Python 패키지 설치 및 의존성 해결 도구입니다. pip, pip‑tools, virtualenv를 한 번에 대체하는 “원스톱 샵”이 되는 것이 목표이며, 벤치마크 결과 전통적인 도구보다 10배‑100배 빠른 것으로 나타났습니다.

VS Code 사용자에게 주는 이점

• 즉시 환경 설정 – 의존성 해결을 기다릴 필요가 없습니다.
• 디스크 공간 효율성 – 전역 캐시가 최적화되어 있습니다.
• 일관성 – uv.lock 파일이 모든 팀원이 동일한 환경을 사용하도록 보장합니다.

Step 1: uv 설치하기

macOS / Linux

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

Windows (PowerShell)

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

설치가 끝난 뒤, 버전을 확인합니다:

uv --version

Step 2: VS Code가 uv를 인식하도록 설정하기

1. 프로젝트 초기화 및 가상 환경 만들기

# 프로젝트 초기화 (pyproject.toml 생성)
uv init

# 가상 환경 생성 (.venv 폴더 생성)
uv venv

2. VS Code에서 인터프리터 선택하기

1. 명령 팔레트 열기 (Ctrl+Shift+P 또는 Cmd+Shift+P).
2. “Python: Select Interpreter.” 선택.
3. 새로 만든 .venv 폴더 안에 있는 Python 실행 파일을 선택.

팁: 환경이 표시되지 않을 경우 settings.json에 다음을 추가합니다:

{
  "python.venvPath": ".",
  "python.venvFolders": [".venv"]
}

Step 3: 패키지 관리 (uv add / uv sync)

프로덕션 패키지 추가:

uv add fastapi

개발 패키지 추가:

uv add --dev pytest

새 팀원이 레포지토리를 클론하면 전체 환경을 즉시 동기화할 수 있습니다:

uv sync

Step 4: 디버깅 설정 (launch.json)

.vscode/launch.json 파일을 만들거나 기존 파일을 편집하고 다음 구성을 추가합니다:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Current File (uv)",
      "type": "python",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "justMyCode": true
    }
  ]
}

이제 중단점을 설정하고 uv가 관리하는 환경 내에서 바로 디버깅할 수 있습니다 (F5 키를 눌러 디버깅 시작).

Pro Tip: Ruff와의 통합

Ruff는 같은 개발팀이 만든 도구라 uv와 완벽하게 어울립니다.

1. VS Code용 Ruff 확장을 설치합니다.
2. Ruff를 개발 의존성으로 추가합니다:

uv add --dev ruff

3. VS Code가 Ruff를 기본 포매터로 사용하도록 설정합니다:

{
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.fixAll": "explicit",
      "source.organizeImports": "explicit"
    }
  }
}

이제 저장할 때마다 코드가 번개 같은 속도로 린트되고 포맷됩니다.

결론

uv로 전환하는 것은 2026년 현재 Python 개발 경험을 크게 향상시킬 수 있는 가장 효과적인 변화 중 하나입니다. VS Code와 Ruff와 결합하면 빠르고 견고하며 현대적인 개발 환경을 손쉽게 구축할 수 있습니다.

Originally published at: