Установка Django в Windows

Установка Python

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

Чтобы установить 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», если она еще не существует, и настроит виртуальную среду. Для активации среды выполните:

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