Python: Разработка на фреймворке Django
2026-02-26 16:58 Diff
https://ru.hexlet.io/courses/python-django-basics/lessons/hello-django/theory_unit

Чтобы начать разбираться с Django, нужно для начала создать на нем проект и запустить. Этим мы и займемся в этом уроке.

Проекты на Django создаются из командной строки. Первым делом создайте новый python-проект в директории hexlet-django-blog и добавьте в зависимости Django.

В случае uv нужно вызывать команды с помощью uv run: uv run django-admin version. И всё остальное точно так же.

Теперь можно создать новый проект с помощью команды:

Эта команда создаст Django-проект в директории hexlet_django_blog и установит все зависимости, которые необходимы для работы Django. Некоторые уточнения:

  • Имя hexlet_django_blog будет именем Python-пакета, поэтому содержит подчеркивание в качестве разделителя
  • Точка в команде означает, что генерируемое содержимое проекта будет расположено в текущей директории. У нас уже есть директория проекта, поэтому нам не нужен лишний уровень вложенности

После установки пакета нам станет доступна команда django-admin — команда для работы с Django-проектами.

Проверим версию текущей установки Django. Для этого выполним команду в директории проекта:

Структура проекта

Современные фреймворки используют, чтобы разрабатывать сайты любых размеров. Это хорошо, так как есть много возможностей. Но с другой стороны в этом легко потеряться из-за большого количества функций, особенно если это ваш первый фреймворк.

Помимо большого числа понятий самого Django, внутри него встроена поддержка шаблонизатора, работа со статикой, разные виды кеширования, тестирование, логирование и многое другое.

Это не значит, что придется использовать сразу всё. Но нужно понимать хотя бы основы каждой функции — на уровне понимания структуры проекта.

Ниже приведена таблица файлов с описанием их содержимого. В этом описании будут встречаться названия, которые вы пока можете не знать. Позже мы их разберем:

В процессе работы над проектом, нам предстоит модифицировать только два модуля: settings.py и urls.py. Если посмотреть в первый, то можно увидеть конфигурацию по умолчанию. Не пугайтесь ее размера, просто ощутите, сколько можно настроить в большом фреймворке.

Запуск проекта

Django управляется утилитой скриптом manage.py, который находится в корне проекта. Он включает в себя десятки команд, которые упрощают процесс разработки. Одна из них — запуск сайта в режиме разработки:

Эта команда запускает встроенный в Django веб-сервер, который работает в однопоточном режиме и сам перезапускается, если что-то менять в коде. Кроме того, этот сервер никогда и ничего не кэширует — это важно при редактировании шаблонов и статических файлов (JS, CSS).

Чтобы увидеть сайт, откройте браузер и загрузите http://127.0.0.1

. Вы увидите приветственную страницу фреймворка:

Чтобы остановить сервер, переключитесь на терминал, в котором он запущен, и наберите CTRL+C. Эта страница нужна только для проверки того, что все работает.

Скрипт manage.py

Скрипт manage.py — центральный пульт управления фреймворка. Через manage.py мы будем автоматически генерировать код, управлять базой данных, запускать сервер, консоль и многое другое. Чтобы увидеть список всех команд, запустите manage.py без аргументов:

Этот список команд может расширяться как нами, так и разработчиками расширений. На GitHub можно найти множество полезных дополнений на все случаи жизни. В последующих уроках мы постоянно будем возвращаться к этому скрипту и изучать его команды и возможности.

Теперь мы готовы изучать работу с Django. Будем это делать с помощью нашего проекта hexlet-django-blog — блога для статей.