Как установить 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

См.также

Для более подробной информации смотрите документацию Using Python on Windows.

О pip

pip - это менеджер пакетов для Python, который по умолчанию входит в состав программы установки Python. Он помогает устанавливать и удалять пакеты Python (например, Django!). В оставшейся части установки мы будем использовать pip для установки пакетов Python из командной строки.

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

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

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

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

Это w […]

...\> 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 также обеспечивает общесистемную настройку путем установки флажка Use Unicode UTF-8 for worldwide language support в Language ‣ Administrative Language Settings ‣ Change system locale в системных настройках.

Как развернуть статические файлы
Как создавать миграции баз данных
Вернуться на верх