Установка Django и запуск первого проекта за 20 минут

К концу этой инструкции у вас будет установленный Django, созданный проект и локальный сервер, который отдаёт стартовую страницу с ракетой по адресу http://127.0.0.1:8000/. На всё уходит 15–20 минут, если Python уже стоит. Никакой теории про MVT и ORM — только команды, которые приводят к результату.

Инструкция написана под Django 5.x и Python 3.12. Django 5.0 требует Python не ниже 3.10, так что версии Python 3.8 и 3.9 не подойдут — на них последняя доступная ветка Django будет 4.2.

Что нужно иметь до начала

Проверьте три вещи, прежде чем ставить Django. Если чего-то не хватает — доберёте на этом же шаге, а не на пятом.

• Python 3.10 или новее. Проверьте командой ниже. На Windows команда обычно python, на macOS и Linux — python3.
• pip — менеджер пакетов, ставится вместе с Python начиная с версии 3.4. Проверяется отдельной командой.
• Терминал. Командная строка (Windows), PowerShell или Terminal на macOS/Linux. Всё делается из него.

# Проверка версии Python
python --version
# или, если предыдущее не сработало:
python3 --version

# Проверка pip
pip --version

Если python --version выдаёт версию ниже 3.10 или команда не найдена — установите свежий Python с python.org (Windows/macOS) или через пакетный менеджер вашей системы. На Windows при установке поставьте галочку Add Python to PATH, иначе терминал не найдёт команду.

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

Django ставят не глобально, а в изолированное виртуальное окружение¹. Так пакеты одного проекта не конфликтуют с другим.

# Создаём папку и заходим в неё
mkdir myfirstsite
cd myfirstsite

# Создаём виртуальное окружение в подпапке venv
python -m venv venv

Проверка: внутри myfirstsite появилась папка venv с подпапками Scripts (Windows) или bin (macOS/Linux).

Шаг 2. Активируйте окружение

Команда активации разная в зависимости от системы.

# Windows (командная строка cmd)
venv\Scripts\activate.bat

# Windows (PowerShell)
venv\Scripts\Activate.ps1

# macOS / Linux
source venv/bin/activate

Проверка: в начале строки терминала появилась приставка (venv). Пока она там — вы внутри окружения, и все команды pip и python относятся к нему.

Если в PowerShell появляется ошибка про политику выполнения скриптов, разрешите её для текущего сеанса командой Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass, а затем снова запустите активацию.

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

# Ставим последнюю версию Django
pip install django

# Проверяем, что установилось
python -m django --version

Проверка: вторая команда выводит номер версии, например 5.1.4. Если хотите зафиксировать конкретную ветку, ставьте с указанием версии: pip install "django>=5.0,<5.1".

Виртуальное окружение — это не бюрократия, а страховка. Через полгода вы вспомните, какая версия Django нужна проекту, посмотрев в requirements.txt, а не гадая, что там в глобальном Python.

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

Django-проект — это каталог с настройками и точкой входа. Обратите внимание на точку в конце команды: она говорит создать проект в текущей папке, а не плодить лишний уровень вложенности.

# Точка в конце обязательна
django-admin startproject config .

Здесь config — имя пакета с настройками. Многие называют его config, чтобы не путать с именем самого проекта; можно назвать и как угодно ещё, кроме зарезервированных слов Python.

Проверка: в папке появились файл manage.py и подпапка config с файлами settings.py, urls.py, wsgi.py, asgi.py.

Что за файлы вы получили

Шаг 5. Примените стартовые миграции

Django из коробки идёт с базой на SQLite и несколькими встроенными приложениями (админка, сессии, пользователи). Их таблицы нужно создать в базе.

python manage.py migrate

Проверка: в терминале пробежит список строк вида Applying auth.0001_initial... OK, а рядом с manage.py появится файл db.sqlite3.

Шаг 6. Запустите сервер разработки

python manage.py runserver

Проверка: в терминале появится строка Starting development server at http://127.0.0.1:8000/. Откройте этот адрес в браузере — вы увидите стартовую страницу Django с надписью об успешной установке и картинкой ракеты. Это значит, что всё работает.

Остановить сервер — сочетание Ctrl+C в терминале. Пока сервер запущен, терминал занят: команды вводите в другом окне (не забыв активировать в нём окружение).

Если не получилось

• django-admin: command not found — окружение не активировано или Django не установлен. Убедитесь, что в строке есть (venv), и повторите шаг 3.
• ModuleNotFoundError: No module named 'django' — вы запускаете команду в окружении, где Django нет. Частая причина: открыли новое окно терминала и забыли активировать venv. Вернитесь к шагу 2.
• Error: That port is already in use. — порт 8000 занят другим процессом или прошлым запуском. Запустите на другом порту: python manage.py runserver 8001 и открывайте http://127.0.0.1:8001/.
• PowerShell: running scripts is disabled on this system — политика выполнения запрещает активацию. Выполните Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass и активируйте окружение снова.
• Страница не открывается, а в терминале тишина — проверьте, что сервер действительно запущен (есть строка Starting development server) и вы открываете именно 127.0.0.1, а не localhost с другим портом.

Что делать дальше

Стартовая страница — это ещё не ваш сайт, а подтверждение, что фундамент собран. Следующие шаги в логическом порядке:

1. Создайте первое приложение: python manage.py startapp main — здесь будет жить ваша логика.
2. Зафиксируйте зависимости: pip freeze > requirements.txt, чтобы окружение можно было воспроизвести.
3. Создайте суперпользователя python manage.py createsuperuser и зайдите в админку по адресу /admin/.
4. Прочитайте официальный вводный туториал Django — он проведёт от пустого проекта до работающего опроса с формами и админкой.

Настройку базы данных на PostgreSQL, развёртывание на боевом сервере и работу с шаблонами оставьте на потом — это отдельные темы, и на локальном SQLite учиться проще.

¹ Виртуальное окружение (venv) — изолированный набор пакетов Python внутри папки проекта. Установленное в нём не влияет на системный Python и другие проекты. Модуль venv входит в стандартную библиотеку Python с версии 3.3.