Как установить 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!). Для дальнейшей установки мы будем использовать pip для установки пакетов Python из командной строки.

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

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

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

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

Это создаст папку с именем «project-name», если она еще не существует, и настроит виртуальную среду. Чтобы активировать среду, выполните:

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

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

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