Установка Django и создание проекта HelloWorld

Шаг 1. Python

Django — это библиотека для Python, поэтому сначала нужен сам Python версии 3.10 или новее. Проверьте:

python --version      # Windows
python3 --version     # macOS / Linux

Если Python не установлен, скачайте его с python.org. На Windows при установке обязательно отметьте Add Python to PATH.

Шаг 2. Папка проекта и виртуальное окружение

Виртуальное окружение — изолированная копия Python для конкретного проекта. Пакеты, установленные в него, не мешают другим проектам: в одном может быть Django 4.2, в другом — 5.2.

mkdir helloworld
cd helloworld
python -m venv venv

Активируем окружение:

# Windows (cmd / PowerShell)
venv\Scripts\activate

# macOS / Linux
source venv/bin/activate

В начале строки терминала появится (venv) — значит, всё работает.

Шаг 3. Установка Django

pip install django
python -m django --version

Сохраним список зависимостей — это пригодится при деплое:

pip freeze > requirements.txt

Шаг 4. Создание проекта

django-admin startproject config .

Точка в конце означает «создать в текущей папке». Получится:

helloworld/
├── manage.py          ← утилита управления проектом
├── config/
│   ├── __init__.py
│   ├── settings.py    ← настройки
│   ├── urls.py        ← главные маршруты
│   ├── asgi.py
│   └── wsgi.py        ← точка входа для веб-сервера
└── venv/

Запускаем сервер разработки:

python manage.py runserver

Откройте http://127.0.0.1:8000/ — вы увидите приветственную страницу с ракетой. Это значит, Django работает!

Шаг 5. Создание приложения

python manage.py startapp hello

hello/
├── __init__.py
├── admin.py       ← регистрация моделей в админке
├── apps.py        ← конфигурация приложения
├── migrations/    ← миграции базы данных
├── models.py      ← модели
├── tests.py       ← тесты
└── views.py       ← представления

Сообщим проекту о приложении — config/settings.py:

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    # ...
    "hello",
]

Шаг 6. Первое представление

hello/views.py:

from django.http import HttpResponse


def index(request):
    return HttpResponse("Hello, World!")

View — обычная функция: получает объект запроса request и возвращает объект ответа HttpResponse.

Шаг 7. Маршруты

Создайте файл hello/urls.py:

from django.urls import path

from . import views

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

И подключите его в главном config/urls.py:

from django.contrib import admin
from django.urls import include, path

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

Обновите http://127.0.0.1:8000/ — Hello, World! 🎉

Полезные команды manage.py

Итог

1. Создаём venv и ставим Django через pip.
2. django-admin startproject — проект, manage.py startapp — приложение.
3. Приложение добавляем в INSTALLED_APPS.
4. View — функция request → HttpResponse, маршрут связывает URL и view.