Este documento lo guiará a través de la instalación de Python 3.8 y Django en Windows. También proporciona instrucciones para configurar un entorno virtual, lo que facilita el trabajo en proyectos de Python. Esto pretende ser una guía para principiantes para usuarios que trabajan en proyectos de Django y no refleja cómo se debe instalar Django al desarrollar parches para Django en sí.

Los pasos de esta guía han sido probados con Windows 10. En otras versiones, los pasos serían similares. Deberá estar familiarizado con el uso del símbolo del sistema de Windows.

Instalar Python

Django es un marco web de Python, por lo que requiere que Python esté instalado en su máquina. Al momento de escribir, Python 3.8 es la última versión.

Para instalar Python en su máquina, vaya a https://python.org/descargas/. El sitio web debería ofrecerle un botón de descarga para la última versión de Python. Descargue el instalador ejecutable y ejecútelo. Marque las casillas junto a “Instalar lanzador para todos los usuarios (recomendado)” y luego haga clic en “Instalar ahora”.

Después de la instalación, abra el símbolo del sistema y verifique que la versión de Python coincida con la versión que instaló ejecutando:

...> py --version

Ver también

Para más detalles, consulte Usando Python en Windows documentación.

Acerca de pip

pepita es un administrador de paquetes para Python y se incluye de forma predeterminada con el instalador de Python. Ayuda a instalar y desinstalar paquetes de Python (¡como Django!). Para el resto de la instalación, usaremos pip para instalar paquetes de Python desde la línea de comandos.

Configuración de un entorno virtual

Es una buena práctica proporcionar un entorno dedicado para cada proyecto de Django que cree. Hay muchas opciones para administrar entornos y paquetes dentro del ecosistema de Python, algunas de las cuales se recomiendan en el Documentación de Python. Python mismo viene con venv para la gestión de entornos que utilizaremos para esta guía.

Para crear un entorno virtual para su proyecto, abra un nuevo símbolo del sistema, navegue a la carpeta donde desea crear su proyecto y luego ingrese lo siguiente:

...> py -m venv project-name

Esto creará una carpeta llamada ‘nombre del proyecto’ si aún no existe y configurará el entorno virtual. Para activar el entorno, ejecute:

...> project-nameScriptsactivate.bat

El entorno virtual se activará y verá “(nombre del proyecto)” junto al símbolo del sistema para designarlo. Cada vez que inicie un nuevo símbolo del sistema, deberá activar el entorno nuevamente.

Instalar Django

Django se puede instalar fácilmente usando pip dentro de su entorno virtual.

En el símbolo del sistema, asegúrese de que su entorno virtual esté activo y ejecute el siguiente comando:

...> py -m pip install Django

Esto descargará e instalará la última versión de Django.

Una vez completada la instalación, puede verificar su instalación de Django ejecutando django-admin --version en el símbolo del sistema.

Ver Pon en marcha tu base de datos para obtener información sobre la instalación de la base de datos con Django.

Salida de terminal de color

Nuevo en Django 3.2.

Una función de calidad de vida es la salida en color (en lugar de monocromática) en el terminal. Esto debería funcionar tanto en CMD como en PowerShell. Si por alguna razón esto necesita ser deshabilitado, configure la variable ambiental DJANGO_COLORS para nocolor.

Para habilitar esto, colorama debe ser instalado:

...> py -m pip install colorama

Ver Coloreado de sintaxis para obtener más información sobre la configuración de color.

Errores comunes

  • Si django-admin solo muestra el texto de ayuda sin importar los argumentos que se le den, probablemente haya un problema con la asociación de archivos en Windows. Compruebe si hay más de una variable de entorno configurada para ejecutar scripts de Python en PATH. Esto suele ocurrir cuando hay más de una versión de Python instalada.

  • Si se está conectando a Internet detrás de un proxy, puede haber problemas al ejecutar el comando py -m pip install Django. Establezca las variables de entorno para la configuración del proxy en el símbolo del sistema de la siguiente manera:

    ...> set http_proxy=http://username:[email protected]:proxyport
...> set https_proxy=https://username:[email protected]:proxyport