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

Привет! Ты решил изучить Django — один из самых популярных фреймворков для веб-разработки на Python. Он подходит для создания всего: от простых блогов до сложных интернет-магазинов и социальных сетей.

Django следует философии «batteries included» (всё включено из коробки). Он предоставляет готовые решения для работы с базами данных, аутентификацией, админ-панелью и многим другим.

В этой статье мы разберём:

• Проверку установки Python и pip
• Создание и активацию виртуального окружения
• Установку Django
• Создание первого Django-проекта
• Запуск development-сервера

Что нужно знать перед началом

Для этого урока тебе понадобится:

• Установленный Python (версия 3.10 или новее)
• Базовое понимание командной строки

Совет: Django — это мощный фреймворк, но начать с ним очень просто. Следуй шагам — и через 15 минут у тебя будет работающий проект.

Основная часть

Проверка установки Python и pip

Django работает на Python. Перед установкой проверь, что Python установлен корректно:

python --version

Ожидаемый вывод: Python 3.12.x или выше.

Проверь, что pip (менеджер пакетов) тоже работает:

pip --version

Важно: Django 6.0 требует Python 3.12 или новее. Для Django 5.2 LTS подойдут версии Python 3.10–3.13.

Создание виртуального окружения

Виртуальное окружение изолирует зависимости проекта и предотвращает конфликты версий библиотек .

Шаг 1. Создай папку для проекта и перейди в неё:

mkdir myblog
cd myblog

Шаг 2. Создай виртуальное окружение:

python -m venv myblog_env

Совет: Папку myblog_env нужно добавить в .gitignore — она не должна попадать в репозиторий.

Шаг 3. Активируй виртуальное окружение:

Windows:

myblog_env\Scripts\activate

macOS / Linux:

source myblog_env/bin/activate

После активации в начале командной строки появится (myblog_env). Это значит, что окружение работает .

Совет: Теперь все установленные пакеты будут попадать только в это окружение, не влияя на глобальные Python-библиотеки.

Установка Django

В активированном виртуальном окружении установи Django с помощью pip:

pip install django

Проверь установку:

python -m django --version

Ожидаемый вывод: 5.2.x или 6.0.x (зависит от версии).

Совет: Если нужна конкретная версия Django, укажи её при установке:

pip install django==5.2.9

Фиксация зависимостей:

Создай файл requirements.txt со всеми установленными пакетами :

pip freeze > requirements.txt

Этот файл позволит воспроизвести окружение на другом компьютере:

pip install -r requirements.txt

Создание Django-проекта

Создай новый проект с помощью утилиты django-admin:

django-admin startproject mysite

После выполнения появится папка mysite со следующей структурой:

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

Назначение файлов:

Важно: Не называй проект django или test — эти имена конфликтуют со встроенными компонентами Python.

Запуск development-сервера

Django поставляется с лёгким встроенным сервером для разработки:

cd mysite
python manage.py runserver

Если всё работает, ты увидишь:

Performing system checks...

System check identified no issues (0 silenced).

June 09, 2026 - 15:50:53
Django version 6.0, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Открой браузер и перейди по адресу: http://127.0.0.1:8000/ .

Ты увидишь страницу с поздравлением «Congratulations!» и ракетой — это значит, что проект работает.

Важно: Этот сервер предназначен только для разработки. Не используй его в продакшене.

Совет: Сервер автоматически перезагружается при изменении кода. Перезапуск не требуется

Создание первого приложения (опционально)

В Django проект состоит из приложений. Каждое приложение отвечает за свою часть функциональности.

Создай приложение:

python manage.py startapp polls

Структура приложения:

polls/
    __init__.py
    admin.py
    apps.py
    models.py
    tests.py
    views.py
    migrations/

Зарегистрируй приложение в settings.py:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'polls.apps.PollsConfig',  # Добавь эту строку
]

Совет: Приложения помогают организовать код и переиспользовать его в разных проектах.

Задачи для закрепления

Задача 1. Проверь, что Python и pip установлены.

Задача 2. Создай виртуальное окружение для Django-проекта.

Задача 3. Установи Django и проверь версию.

Задача 4. Создай проект с именем myblog.

Задача 5. Запусти development-сервер и открой страницу в браузере.

Ответы:

Задача 1.

python --version
pip --version

Задача 2.

python -m venv myblog_env
# Windows: myblog_env\Scripts\activate
# macOS/Linux: source myblog_env/bin/activate

Задача 3.

pip install django
python -m django --version

Задача 4.

django-admin startproject myblog

Задача 5.

cd myblog
python manage.py runserver
# Перейти в браузере по адресу http://127.0.0.1:8000/

Нюансы и подводные камни

Неправильная версия Python

Если Django не устанавливается, проверь версию Python. Django 6.0 требует Python 3.12+.

Забыл активировать виртуальное окружение

Убедись, что перед установкой пакетов активировано виртуальное окружение. Имя окружения должно отображаться в начале командной строки.

Порт 8000 занят

Если порт 8000 занят, можно запустить сервер на другом порту:

python manage.py runserver 8080

Шпаргалка

Заключение

Сегодня мы:

• Проверили установку Python и pip
• Создали и активировали виртуальное окружение
• Установили Django
• Создали первый Django-проект
• Запустили development-сервер

КВИЗ

Что дальше?

• Следующая статья: «Структура проекта Django: settings, urls, wsgi»