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

Установка Python

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

Чтобы установить Python на компьютер, перейдите на страницу https://www.python.org/downloads/. На сайте должна отображаться кнопка загрузки последней версии Python. Скачайте исполняемый файл установщика и запустите его. Установите флажок рядом с пунктом «Install launcher for all users (recommended)», затем нажмите «Install Now».

После установки откройте командную строку и проверьте, совпадает ли версия 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 возникла проблема с ассоциацией файлов. Проверьте, не задано ли в PATH несколько переменных среды для запуска скриптов Python. Обычно это происходит, если установлено несколько версий 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 в разделе Язык ‣ Административные языковые параметры ‣ Изменить язык системы в системных настройках.