• 3.1
  • 3.2
  • 5.0
  • Версия документации: 6.1

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

This document will guide you through installing Python 3.14 and Django on Windows. It also provides instructions for setting up a virtual environment, which makes it easier to work on Python projects. This is meant as a beginner’s guide for users working on Django projects and does not reflect how Django should be installed when developing changes for Django itself.

Действия в этом руководстве были протестированы в Windows 7, 8 и 10. В других версиях шаги будут аналогичными. Вам необходимо будет уметь использовать командную строку Windows.

Установка Python

Django is a Python web framework, thus requiring Python to be installed on your machine. At the time of writing, Python 3.14 is the latest version.

Чтобы установить Python на свой компьютер, перейдите по ссылке https://www.python.org/downloads/. На сайте должна быть кнопка загрузки последней версии Python. Загрузите исполняемый установщик и запустите его. Установите флажки рядом с «Установить средство запуска для всех пользователей (рекомендуется)», затем нажмите «Установить cейчас».

После установки откройте командную строку и проверьте, что версия Python соответствует установленной вами версии, выполнив:

...\> py --version

py не распознан или не найден

В зависимости от того, как вы установили Python (например, через Microsoft Store), py может быть недоступен в командной строке.

Тогда вам нужно будет использовать python вместо py при вводе команд.

См.также

Более подробную информацию см. в документации python:using/windows.

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

Back to Top