Django 시작하기

이 장에서는 파이썬 가상 환경을 만들고 Django를 설치한 뒤, 새 프로젝트를 만들어 개발 서버로 실행하는 데까지 다룹니다. 첫 앱을 추가하고 편집기를 설정하는 방법도 함께 살펴봅니다.

준비물: 파이썬과 가상 환경

Django는 파이썬 패키지이므로 먼저 파이썬이 설치되어 있어야 합니다. Django의 각 버전은 지원하는 파이썬 버전 범위가 정해져 있으니, 공식 문서의 설치 안내에서 현재 버전이 요구하는 파이썬 버전을 확인합니다.

프로젝트마다 의존성을 따로 관리하려면 가상 환경(virtual environment)을 만듭니다. 가상 환경은 프로젝트 폴더 안에 독립된 파이썬 실행 환경을 두어, 다른 프로젝트나 시스템 파이썬과 패키지가 섞이지 않게 합니다.

mkdir mysite-project
cd mysite-project

# 가상 환경 만들기
python -m venv .venv

# macOS · Linux에서 활성화
source .venv/bin/activate

# Windows(PowerShell)에서 활성화
.venv\Scripts\Activate.ps1

활성화되면 프롬프트 앞에 (.venv)가 붙습니다. 이후 실행하는 python과 pip은 모두 가상 환경 안의 것입니다. 작업을 마치면 deactivate로 빠져나옵니다.

Django 설치

가상 환경이 켜진 상태에서 pip으로 Django를 설치합니다. 설치한 패키지 목록은 requirements.txt에 적어 두면 다른 사람이나 서버에서 같은 환경을 다시 만들 수 있습니다.

python -m pip install Django

# 설치된 버전 확인
python -m django --version

# 의존성 목록 저장
python -m pip freeze > requirements.txt

pip freeze는 설치된 모든 패키지를 정확한 버전과 함께 적습니다. 직접 관리하고 싶다면 requirements.txt를 손으로 작성해도 됩니다. 요즘은 uv나 Poetry 같은 도구로 의존성을 관리하는 팀도 많지만, 기본 흐름은 같습니다.

프로젝트 만들기

Django에서 프로젝트는 설정과 URL 구성을 묶는 전체 사이트이고, 앱은 블로그·투표처럼 하나의 기능을 맡는 파이썬 패키지입니다. 프로젝트는 django-admin startproject로 만듭니다.

# 현재 폴더(.)에 mysite 프로젝트 만들기
django-admin startproject mysite .

# 기본 앱(admin, auth 등)이 쓰는 테이블 만들기
python manage.py migrate

# 개발 서버 실행
python manage.py runserver

끝에 .을 붙이면 현재 폴더에 manage.py가 생기고, 설정 패키지 mysite/가 그 옆에 만들어집니다. 브라우저에서 http://127.0.0.1:8000/을 열면 Django 환영 페이지가 보입니다. 다른 포트를 쓰려면 python manage.py runserver 8080처럼 포트를 넘깁니다.

개발 서버는 코드가 바뀌면 자동으로 다시 시작하지만, 운영 환경용이 아닙니다. 성능과 보안 검토를 거치지 않았으므로 배포할 때는 Gunicorn이나 Uvicorn 같은 서버를 씁니다(6장).

첫 앱 만들기

기능은 앱 단위로 나눕니다. startapp으로 앱을 만들고 설정의 INSTALLED_APPS에 등록합니다.

python manage.py startapp polls

# mysite/settings.py
INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    "polls",
]

이제 간단한 뷰를 만들고 URL에 연결합니다.

# polls/views.py
from django.http import HttpResponse


def index(request):
    return HttpResponse("투표 앱에 오신 것을 환영합니다.")

# polls/urls.py (새 파일)
from django.urls import path

from . import views

app_name = "polls"
urlpatterns = [
    path("", views.index, name="index"),
]

# mysite/urls.py
from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path("polls/", include("polls.urls")),
    path("admin/", admin.site.urls),
]

http://127.0.0.1:8000/polls/를 열면 방금 쓴 문장이 나옵니다. include()는 앱의 URL 목록을 프로젝트 URL 아래에 붙입니다.

관리자 계정 만들기

Django에는 관리자 화면이 기본으로 들어 있습니다. 관리자 계정을 만들고 /admin/에 로그인해 봅니다.

python manage.py createsuperuser

편집기 설정

VS Code를 쓴다면 Microsoft의 Python 확장을 설치하고, 명령 팔레트의 "Python: Select Interpreter"에서 .venv 안의 인터프리터를 고릅니다. PyCharm Professional은 Django 프로젝트를 인식해 템플릿과 URL 이동을 지원합니다. 코드 정리는 Ruff나 Black, 템플릿 정리는 djLint 같은 도구를 많이 씁니다.

정리

• 프로젝트마다 python -m venv로 가상 환경을 만들고 그 안에 Django를 설치합니다.
• django-admin startproject로 프로젝트를, python manage.py startapp으로 앱을 만듭니다.
• 새 앱은 INSTALLED_APPS에 등록하고, include()로 URL을 연결합니다.
• runserver는 개발용 서버이며, 운영에는 별도의 WSGI·ASGI 서버를 씁니다.