Django에서 UV로 가상환경 설정하기

⚡ uv로 빠르게 Django 가상환경 설정하기 (Mac 기준, uv add 기준)

최근 uv라는 초고속 Python 패키지 매니저가 각광받고 있다. uv는 기존의 pip, virtualenv, poetry를 대체하거나 보완할 수 있는 매우 강력하고 빠른 도구이다. 이 글에서는 uv의 add 명령어를 중심으로 Django 프로젝트를 설정하는 과정이다.

---

✅ uv란?

uv는 Astral Software에서 만든 Python 패키지 매니저로,
pip, virtualenv, pip-tools, poetry의 기능을 하나로 통합한 빠르고 현대적인 도구.

공식 사이트: https://astral.sh

---

1. uv 설치

터미널에서 아래 명령어를 입력:

brew install uv

설치가 완료되면 아래 명령어로 버전 확인:

uv --version

---

2. Django 프로젝트 디렉토리 만들기

mkdir my_django_project
cd my_django_project

---

3. 가상환경 생성

uv는 가상환경을 자동으로 만들 수 있다:

uv venv

• .venv/ 디렉토리가 생성.
• 기존의 python -m venv와 동일하지만 훨씬 빠름.

가상환경 활성화:

source .venv/bin/activate

---

4. Django 설치 (uv add 사용)

uv add 명령어는 패키지를 설치하면서 pyproject.toml에 의존성으로 기록.

uv add django

이제 pyproject.toml에 다음과 같이 기록:

[project]
dependencies = ["django"]

---

5. Django 프로젝트 생성

django-admin startproject config .

이 명령은 현재 디렉토리에 Django 프로젝트를 생성.

---

6. 개발 서버 실행

python manage.py runserver

정상적으로 실행되면 브라우저에서 http://127.0.0.1:8000 접속!

---

7. 자주 쓰는 uv 명령어 요약

기능	명령어
가상환경 생성	uv venv
가상환경 실행	source .venv/bin/activate
패키지 설치 및 등록	uv add <패키지>
패키지 제거	uv remove <패키지>
의존성 확인	uv pip freeze
의존성 설치 (from pyproject.toml)	uv pip install

---

✅ 마무리

uv add를 활용하면 Python 프로젝트의 의존성 관리를 더 체계적이고 빠르게 할 수 있다.