Como instalar o Django no Windows

Este documento irá lhe guiar através da instalação do Python 3.5 e Django no Windows. Ele também fornece instruções para instalar o virtualenv e virtualenvwrapper, os quais facilitam trabalhar com projetos Python. Ele serve como um guia de iniciantes para os usuários trabalhando em projetos Django e não reflete como o Django deveria ser instalado quando for para desenvolver “patches” para o próprio Django.

Os passos para este guia foram testados no windows 7, 8, e 10. Em outras versões, os passos devem ser similares. Você deve estar familiarizado com o uso da linha de comando do Windows.

Instalando Python

Django é um framework web Python, então requer que o Python seja instalado no computador. Enquanto escrevo, o Python 3.5 é a última versão.

Para instalar o Python na sua máquina acesse https://python.org/downloads/. O site irá mostrar um botão para baixar a última versão do Python. Baixe o executável do instalador e execute-o. Selecione a checkbox próxima a Add Python 3.5 to PATH e então clique em Install Now.

Depois da instalação, abra a linha comando e verifique se a versão do Python é a mesma que a versão instalada executando:

python --version

Sobre o pip

O pip é o gerenciador de pacotes do Python. Ele faz com que instalar e desinstalar pacotes Python (tal como Django) muito fácil. Para o resto da instalação, usaremos o pip para instalar pacotes Python da linha de comando.

Para instalar o “pip” na sua máquina, acesse https://pip.pypa.io/en/latest/installing/, e siga as instruções Installing with get-pip.py.

Instalando virtualenv e virtualenvwrapper

O virtualenv e virtualenvwrapper nos dá um ambiente dedicado para cada projeto Django que você criar. Enquanto isso não é obrigatório, é considerado a melhor prática e irá lhe economizar tempo no futuro quando estiver pronto para implantar seu sistema. Simplesmente digite:

pip install virtualenvwrapper-win

Então crie um ambiente virtual para seu projeto:

mkvirtualenv myproject

O ambiente virtual será ativado automaticamente e você irá ver “(myproject)” próximo ao “prompt” na linha de comando que indica isso. Se você iniciar uma nova linha de comando, você irá precisar ativar o ambiente novamente usando:

workon myproject

Instalando Django

O Django pode ser facilmente instalado dentro de seu ambiente virtual usando o pip.

Na linha de comando, assegure-se que seu ambiente virtual esteja ativo, e execute o seguinte comando:

pip install django

Isso irá baixar e instalar a última versão do Django.

Depois que a instalação for concluída, você pode verificar sua instalação do Django executando django-admin --version na linha de comando.

Veja Tenha seu banco de dados rodando para informações sobre a instalação do banco de dados com Django.

Armadilhas comuns

• Se o django-admin somente mostra o texto de ajuda não importando quais argumentos lhe é dado, provavelmente tem um problema com a associação do arquivo no windows. Verifique se existe mais de uma variável de ambiente definida para rodar os scripts Python no PATH. Isso normalmente ocorre quando existe mais de uma versão de Python instalada.

• Se você está conectado na internet atrás de um proxy, pode haver um problema ao rodar o comando pip install django. Defina as variáveis de ambiente para configuração do proxy na linha de comando como a seguir:

  set http_proxy=http://username:password@proxyserver:proxyport
  set https_proxy=https://username:password@proxyserver:proxyport