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

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

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

Установка Python

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

Чтобы установить 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:

...\> py -m pip install colorama

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

Общие ошибки

• Если 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 в Язык ‣ Административные языковые параметры ‣ Изменить системный язык в системных настройках.