Как установить Django: pip install django на Windows, macOS и Linux

Чтобы установить Django, создайте виртуальное окружение, активируйте его и выполните pip install django. Pip скачает последнюю версию фреймворка, совместимую с вашим Python, вместе с зависимостями. Проверить результат можно командой python -m django --version.

python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
python -m pip install django
python -m django --version
# → 6.1.2

Ниже — подробная установка Django для Windows, macOS и Linux, выбор версии, файл requirements.txt и разбор ошибок, на которых чаще всего спотыкаются новички. Команды проверены на Python 3.12 с Django 6.1 и 5.2 LTS.

Что нужно до установки Django

Django — это пакет Python, поэтому сначала нужен сам интерпретатор. Если Python ещё не установлен, начните с руководства «Как установить Python», а версию проверьте так:

# Windows
py --version
python --version

# macOS / Linux
python3 --version

Версия Python определяет, какую версию Django вы получите:

Версия Django	Поддерживаемый Python	Комментарий
6.1 (актуальная)	3.12 и новее	ставится по умолчанию на Python 3.12+
6.0	3.12 и новее	предыдущий выпуск ветки 6.x
5.2 LTS	3.10 и новее	версия с длительной поддержкой

Если у вас Python 3.10 или 3.11, команда pip install django молча установит последнюю совместимую версию — Django 5.2 LTS. Для новых проектов разумно взять Python 3.12 или новее, чтобы получить актуальную ветку. Подробнее о проверке версии — в статье «Как узнать версию Python».

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

Устанавливать Django глобально в систему не стоит: у разных проектов бывают разные версии зависимостей, а Python из Homebrew на macOS и системный Python в современных дистрибутивах Linux (Debian 12+, Ubuntu 23.04+) блокируют глобальный pip install ошибкой externally-managed-environment. Устанавливайте Django в виртуальное окружение в папке проекта.

Windows (PowerShell или cmd):

mkdir mysite
cd mysite
py -m venv .venv
.venv\Scripts\activate

macOS и Linux:

mkdir mysite
cd mysite
python3 -m venv .venv
source .venv/bin/activate

После активации в начале строки приглашения появится (.venv). Внутри активного окружения команда python указывает на Python окружения, поэтому дальше на всех системах можно писать просто python.

Важно: на Debian и Ubuntu модуль venv иногда ставится отдельным пакетом. Если python3 -m venv ругается на отсутствие ensurepip, установите sudo apt install python3-venv.

Установите Django через pip

python -m pip install django

Запуск pip через python -m pip гарантирует, что пакет попадёт именно в тот Python, который сейчас активен. Вместе с Django установятся его зависимости — asgiref и sqlparse, а на Windows ещё и tzdata с базой часовых поясов:

python -m pip freeze
# → asgiref==3.12.1
# → Django==6.1.2
# → sqlparse==0.6.0
# → tzdata==2026.5      (только Windows)

Номера версий у вас могут отличаться — pip берёт самые свежие на момент установки. О самом менеджере пакетов подробно рассказано в статье «pip в Python».

Проверьте, что Django установлен

Любая из команд выводит версию:

python -m django --version
# → 6.1.2

django-admin --version
# → 6.1.2

Из Python-кода:

import django

print(django.get_version())  # → 6.1.2
print(django.VERSION)        # → (6, 1, 2, 'final', 0)

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

django-admin startproject config .
python manage.py runserver

Как установить конкретную версию Django

Чтобы зафиксировать ветку (например, LTS), укажите ограничение версии. Кавычки обязательны: без них символы < и > командная оболочка воспримет как перенаправление.

# последняя версия ветки 5.2 LTS
python -m pip install "django~=5.2.0"

# то же самое явным диапазоном
python -m pip install "django>=5.2,<6.0"

# точная версия
python -m pip install "django==5.2.18"

Оператор ~=5.2.0 означает «5.2.x, но не 5.3» — удобно, чтобы получать исправления безопасности без перехода на новую ветку.

Обновление и удаление Django

# обновить до последней совместимой версии
python -m pip install --upgrade django

# удалить
python -m pip uninstall django

Перед обновлением между ветками (например, с 5.2 на 6.x) прочитайте release notes в официальной документации: там перечислены удалённые и изменённые API. После обновления запустите python manage.py check и тесты проекта.

requirements.txt: как зафиксировать зависимости

Чтобы проект можно было развернуть на другом компьютере или сервере, запишите зависимости в файл:

python -m pip freeze > requirements.txt

На новой машине достаточно создать окружение и выполнить:

python -m pip install -r requirements.txt

Многие предпочитают вести requirements.txt вручную и указывать только прямые зависимости с диапазоном версий — например, Django~=6.1.0. Так файл остаётся читаемым, а pip сам подтянет asgiref и sqlparse.

Дополнительные компоненты при установке

У пакета Django есть необязательные extras. Например, для хеширования паролей алгоритмом Argon2:

python -m pip install "django[argon2]"

Драйверы баз данных ставятся отдельно: для PostgreSQL обычно psycopg (pip install "psycopg[binary]"), для MySQL — mysqlclient. По умолчанию новый проект работает с SQLite, которая входит в стандартную библиотеку Python, — для обучения ничего дополнительно ставить не нужно.

Частые ошибки при установке Django

«pip» или «python» не является внутренней или внешней командой

Python не добавлен в PATH. На Windows используйте лаунчер py (py -m pip install django) или переустановите Python с галочкой Add python.exe to PATH. На macOS и Linux вместо python и pip вызывайте python3 и python3 -m pip.

«django-admin» не распознано как имя командлета

Ошибка PowerShell (в cmd — «не является внутренней или внешней командой») означает, что окружение с Django не активировано или Django установлен в другой Python. Активируйте окружение (.venv\Scripts\activate) или вызовите утилиту через модуль — это работает всегда, когда Django установлен в текущий Python:

python -m django startproject config .

Выполнение сценариев отключено в этой системе

PowerShell по умолчанию может запрещать запуск Activate.ps1. Разрешите локальные скрипты для текущего пользователя и повторите активацию:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
.venv\Scripts\activate

Альтернатива без изменения политики — работать в cmd и активировать окружение через .venv\Scripts\activate.bat.

ModuleNotFoundError: No module named ‘django’

Django установлен не в тот интерпретатор, которым вы запускаете manage.py. Типичные причины: окружение не активировано, в редакторе (VS Code, PyCharm) выбран системный Python, или пакет ставился командой pip от другой версии Python. Проверьте, какой Python запускается, и поставьте Django именно в него:

python -c "import sys; print(sys.executable)"
python -m pip install django

Подробный разбор — в статье ModuleNotFoundError в Python.

Could not find a version that satisfies the requirement django==6.1

Pip не нашёл подходящую версию. Если выше в выводе есть строка Ignored the following versions that require a different python version: 6.0 Requires-Python >=3.12, значит, ваш Python слишком старый для этой ветки. Обновите Python до 3.12+ или установите Django 5.2 LTS.

error: externally-managed-environment

Так Python из Homebrew на macOS и современные Linux-дистрибутивы защищают системный Python от пакетов, установленных мимо пакетного менеджера. Флаг --break-system-packages снимает защиту и может сломать системные утилиты. Создайте виртуальное окружение в папке проекта, как описано в начале инструкции, и устанавливайте Django в него.

Чек-лист установки

• Python 3.12+ установлен (или 3.10–3.11 для Django 5.2 LTS)
• в папке проекта создано и активировано окружение .venv
• Django установлен командой python -m pip install django
• python -m django --version выводит версию
• зависимости записаны в requirements.txt

Частые вопросы

Как установить Django в PyCharm или VS Code?

Отдельной кнопки для Django не нужно: выберите в редакторе интерпретатор из .venv проекта (в VS Code — команда Python: Select Interpreter, в PyCharm — Settings → Python Interpreter) и выполните python -m pip install django во встроенном терминале. Если редактор указывает на системный Python, импорт django будет подсвечен как ошибка, даже когда пакет установлен в окружение.

Можно ли установить Django через uv или Poetry?

Да. Эти менеджеры сами создают окружение и записывают зависимость в pyproject.toml:

uv add django        # проект под управлением uv
poetry add django    # проект под управлением Poetry

Запускать команды Django тогда удобнее через менеджер: uv run python manage.py runserver или poetry run python manage.py runserver.

Куда устанавливается Django?

В папку site-packages того Python, которым вызван pip. Для окружения это .venv\Lib\site-packages на Windows и .venv/lib/python3.X/site-packages на macOS и Linux. Точный путь и зависимости показывает команда:

python -m pip show django
# → Version: 6.1.2
# → Location: ...\.venv\Lib\site-packages
# → Requires: asgiref, sqlparse, tzdata

Работает ли Django с Python 3.14?

Да. Python 3.14 поддерживают Django 6.0 и 6.1, а в ветке 5.2 LTS совместимость добавлена с выпуска 5.2.8. На Python 3.14 команда pip install django поставит Django 6.1.

Нужно ли ставить Django заново для каждого проекта?

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

Как установить Django на сервер или хостинг?

Так же, как локально: подключитесь по SSH, создайте окружение в папке проекта и выполните python -m pip install -r requirements.txt. На виртуальном сервере дальше настраивают Gunicorn и Nginx — пошагово это описано в статье «Деплой Django: Gunicorn и Nginx». На виртуальном хостинге проверьте, есть ли SSH-доступ и Python 3.12+: без них актуальную версию Django не поставить.

Итог

Установка Django — это три команды: создать виртуальное окружение, активировать его и выполнить pip install django. Почти все ошибки на этом этапе связаны с тем, что пакет ставится в один Python, а запускается другой, — поэтому всегда работайте внутри активного окружения и вызывайте pip как python -m pip.

Дальше — создание проекта командой startproject и первое приложение через startapp. Общий маршрут изучения фреймворка собран в руководстве «Django для начинающих».