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