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

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

This document will guide you through installing Python 3.8 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 patches 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.8 is the latest version.

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

After installation, open the command prompt and check that the Python version matches the version you installed by executing:

...\> py --version

См.также

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

О pip

pip is a package manager for Python and is included by default with the Python installer. It helps to install and uninstall Python packages (such as Django!). For the rest of the installation, we’ll use pip to install Python packages from the command line.

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

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

To create a virtual environment for your project, open a new command prompt, navigate to the folder where you want to create your project and then enter the following:

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

This will create a folder called „project-name“ if it does not already exist and setup the virtual environment. To activate the environment, run:

...\> project-name\Scripts\activate.bat

Виртуальная среда будет активирована, и вы увидите «(имя-проекта)» рядом с командной строкой, чтобы обозначить это. Каждый раз, когда вы запускаете новую командную строку, вам нужно будет снова активировать среду.

Установка Django

Django можно легко установить с помощью pip в вашей виртуальной среде.

In the command prompt, ensure your virtual environment is active, and execute the following command:

...\> py -m pip install Django

Это позволит загрузить и установить последнюю версию Django.

После завершения установки вы можете проверить установку Django, выполнив django-admin --version в командной строке.

См. Создание рабочей базы данных для получения информации об установке базы данных для Django.

Цветной вывод в терминале

New in Django 3.2.

Функция добавляет цветной (а не монохромный) вывод в терминал. В современных терминалах это должно работать как для CMD, так и для PowerShell. Если по какой-то причине это необходимо отключить, установите для переменной среды DJANGO_COLORS значение nocolor.

On older Windows versions, or legacy terminals, colorama must be installed to enable syntax coloring:

...\> py -m pip install colorama

Дополнительную информацию о настройках цвета см. в разделе Подсветка синтаксиса.

Распространенные ошибки

  • Если django-admin отображает только текст справки, независимо от того, какие аргументы ему указаны, вероятно, проблема с ассоциацией файлов в Windows. Проверьте, не задано ли более одной переменной среды для запуска скриптов Python в PATH. Обычно это происходит, когда установлено более одной версии Python.

  • If you are connecting to the internet behind a proxy, there might be problems in running the command py -m pip install Django. Set the environment variables for proxy configuration in the command prompt as follows:

    ...\> 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