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