Как установить Django в Windows

Этот документ поможет вам установить Python 3.12 и Django в Windows. Он также содержит инструкции по настройке виртуальной среды, что упрощает работу над проектами Python. Данное руководство предназначено для начинающих пользователей, работающих с проектами Django, и не отражает, как Django должен быть установлен при разработке изменений для самого Django.

Шаги в этом руководстве были протестированы на Windows 10. В других версиях шаги будут похожи. Вам потребуется знание работы с командной строкой Windows.

Установка Python

Django — это веб-фреймворк для Python, поэтому для его работы требуется установленный Python на вашем компьютере. На момент написания этой статьи последней версией является Python 3.12.

Чтобы установить Python на свой компьютер, перейдите по ссылке https://www.python.org/downloads/. На сайте должен быть доступен раздел для скачивания последней версии Python. Скачайте установочный файл и запустите его. Установите флажки рядом с пунктом «Установить загрузчик для всех пользователей (рекомендуется)», затем нажмите «Установить сейчас».

После установки откройте командную строку и проверьте, что версия Python соответствует установленной вами версии, выполнив:

...\> py --version

О pip

pip — это менеджер пакетов для Python и по умолчанию входит в состав установщика Python. Он помогает устанавливать и удалять пакеты Python (например, Django!). В дальнейшем для установки пакетов Python из командной строки будем использовать pip.

Настройка виртуальной среды

Рекомендуется создавать отдельную среду для каждого проекта Django. Существует множество вариантов управления средами и пакетами в экосистеме Python, некоторые из которых рекомендуются в документации Python. Сам Python поставляется с venv для управления средами, которое мы и будем использовать в этом руководстве.

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

...\> py -m venv project-name

Это создаст папку с именем ‘имя-проекта’, если она ещё не существует, и настроит виртуальную среду. Чтобы активировать среду, выполните:

...\> project-name\Scripts\activate.bat

Виртуальная среда будет активирована, и вы увидите “(имя-проекта)” рядом с командной строкой, чтобы обозначить это. Каждый раз, когда вы запускаете новую командную строку, вам нужно будет снова активировать среду.

Установка Django

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

В командной строке убедитесь, что ваша виртуальная среда активна, и выполните следующую команду:

...\> py -m pip install Django

Это загрузит и установит последнюю версию Django.

После завершения установки вы можете проверить установку Django, выполнив django-admin --version в командной строке.

См. Запуск вашей базы данных для получения информации об установке базы данных с Django.

Вывод цветного текста в терминале

Функция повышения удобства работы добавляет цветной (а не монохромный) вывод в терминал. В современных терминалах это должно работать как в CMD, так и в PowerShell. Если по какой-то причине это нужно отключить, установите переменную окружения DJANGO_COLORS в значение nocolor.

В более старых версиях Windows или устаревших терминалах для включения синтаксического вывода необходимо установить colorama 0.4.6+:

...\> py -m pip install "colorama >= 0.4.6"

См. Синтаксический вывод цвета для получения дополнительной информации о настройках цвета.

Общие ошибки

• Если django-admin отображает только текст справки независимо от передаваемых аргументов, вероятно, проблема с ассоциацией файлов в Windows. Проверьте, установлено ли более одной переменной среды для запуска скриптов Python в PATH. Это обычно происходит при установке нескольких версий Python.

• Если вы подключены к интернету через прокси-сервер, могут возникнуть проблемы при запуске команды py -m pip install Django. Установите переменные среды для настройки прокси в командной строке следующим образом:

  ...\> set http_proxy=http://username:password@proxyserver:proxyport
  ...\> set https_proxy=https://username:password@proxyserver:proxyport
  

• В целом Django предполагает, что кодировка UTF-8 используется для ввода/вывода. Это может вызвать проблемы, если ваша система настроена на использование другой кодировки. В последних версиях Python можно установить переменную среды PYTHONUTF8, чтобы принудительно использовать кодировку UTF-8. Windows 10 также предоставляет настройку на уровне системы, проверяя Use Unicode UTF-8 for worldwide language support в Язык ‣ Административные настройки языка ‣ Изменить системный язык в системных настройках.