Отдельное окружение для проекта

Начните с пустой папки и виртуального окружения. Так зависимости учебного проекта не смешаются с пакетами других приложений. Примеры этой серии используют Django 5.2 и Python 3.12 или новее; это выбранная версия для упражнений, а не команда установки последнего релиза.

Ниже приведены команды для Linux и macOS. В Windows активация окружения выполняется через .venv\Scripts\activate. После активации убедитесь, что команда python указывает на интерпретатор внутри проекта.

Пример кода
mkdir django-notes
cd django-notes
python3 -m venv .venv
source .venv/bin/activate
python -m pip install 'Django~=5.2.0'
python -m django --version

Проект и одно приложение

Проект хранит настройки и корневые маршруты. Приложение содержит модели, views и шаблоны. Для небольшого сайта достаточно одного приложения core. Точка в команде startproject размещает manage.py прямо в текущей папке.

Добавьте "core" в список INSTALLED_APPS файла config/settings.py. Сгенерированные Django middleware оставьте на месте. Команда migrate применит встроенные миграции к локальной SQLite-базе.

Пример кода
django-admin startproject config .
python manage.py startapp core
python manage.py migrate

Первая view и маршрут

View принимает объект запроса и возвращает HTTP-ответ. Здесь не нужны классы или дополнительные слои: простая функция полностью описывает действие. В config/urls.py добавьте маршрут главной страницы, сохранив существующий маршрут админки.

Пример кода
# core/views.py
from django.http import HttpResponse

def home(request):
    return HttpResponse("Первый Django-проект работает.")

# config/urls.py
from django.contrib import admin
from django.urls import path
from core.views import home

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", home, name="home"),
]

Проверка результата

В своём учебном окружении выполните python manage.py runserver и откройте адрес, напечатанный Django. Вы должны увидеть текст ответа. Измените строку и обновите страницу: это короткий цикл разработки, к которому мы будем возвращаться.

Сервер разработки предназначен для локальных упражнений. Публикацию приложения рассматриваем отдельно. Следующий шаг — вынести разметку в шаблон и передать в него данные через контекст.