Come installare Django su Windows

Questo documento ti guiderà su come installare Python 3.8 e Django su Windows. Offre anche istruzioni su come creare un virtual environment, che rende più facile lavorare su progetti Python. E” intesa come guida per principianti per utenti che lavorano a progetti Django e non riflette come Django dovrebbe essere installato quando si sviluppano patch per Django stesso.

I passaggi in questa guida sono stati testati su Windows 10. Nelle altre versioni, i passaggi dovrebbero essere simili. Potrebbe aiutare una conoscenza del prompt di comandi di Windows.

Installa Python

Django è un Python framework web, che richiede che Python sia installato sulla tua macchina. Al momento della stesura, Python 3.8 è l’ultima versione.

Per installare Python sulla tua macchina vai a https://www.python.org/downloads/.  Il sito web dovrebbe offrire un pulsante download per l’ultima versione di Python. Scarica l’installer eseguibile e lancialo. Spunta il box vicino a «Install launcher for all users (recommended)» e poi clicca su «Install Now».

Dopo l’installazione, apri il prompt dei comandi e verifica che la versione di Python corrisponda a quella che hai installato eseguendo:

...\> py --version

Vedi anche

Per maggiori dettagli, vedere la documentazione Using Python on Windows.

Su pip

pip è un gestore di pacchetti per Python ed è incluso per impostazione predefinita con il programma di installazione di Python. Aiuta a installare e disinstallare i pacchetti Python (come Django!). Per il resto dell’installazione utilizzeremo pip per installare i pacchetti Python dalla riga di comando.

Impostazione di un ambiente virtuale

È buona norma fornire un ambiente dedicato per ogni progetto Django che crei. Ci sono molte opzioni per gestire ambienti e pacchetti all’interno dell’ecosistema Python, alcune delle quali sono consigliate nella Documentazione Python. Python stesso viene fornito con venv per la gestione degli ambienti che useremo per questa guida.

Per creare un ambiente virtuale per il tuo progetto, apri un nuovo prompt dei comandi, vai alla cartella in cui vuoi creare il tuo progetto e quindi inserisci quanto segue:

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

Questo creerà una cartella chiamata “nome-progetto” se non esiste già e configurerà l’ambiente virtuale. Per attivare l’ambiente, eseguire:

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

L’ambiente virtuale verrà attivato e vedrai «(nome-progetto)» accanto al prompt dei comandi per designarlo. Ogni volta che avvii un nuovo prompt dei comandi, dovrai attivare nuovamente l’ambiente.

Installa Django

Django puo essere installato utilizzando pip nel tuo ambiente virtuale.

Nel promt dei commandi, assicurati che il tuo ambiente virtuale sia attivo, ed esegui i seguenti comandi:

...\> py -m pip install Django

Questo scarichera e installera l’ultima versione di Django

Dopo che l’installazione è stata completata, puoi verificare la tua installazione di Django eseguendo django-admin --version nel prompt dei comandi.

Vedere Get your database running per informazioni sull’installazione del database con Django.

Risultato colorato del terminale

Una funzione di qualità della vita aggiunge un output colorato (anziché monocromatico) al terminale. Nei terminali moderni questo dovrebbe funzionare sia per CMD che per PowerShell. Se per qualche motivo questo deve essere disabilitato, imposta la variabile ambientale DJANGO_COLORS su nocolor.

Sulle versioni precedenti di Windows o sui terminali legacy (retrocompatibili), colorama deve essere installato per abilitare la colorazione della sintassi:

...\> py -m pip install colorama

Vedere Syntax coloring per ulteriori informazioni sulle impostazioni del colore.

Insidie comuni

• Se django-admin mostra solo un testo di aiuto, non importa che argomenti gli si diano, probabilmente c’è un problema di associazione di file in Windows. Controlla se c’è più di una variabile di ambiente impostata per lanciare gli script Python in PATH. Questo generalmente accade quando c’è più di una versione di Python installata.

• Se ti stai connettendo ad internet con un proxy, potrebbero esserci problemi nel lanciare il comando py -m pip install Django. Imposta le variabili di ambiente per la configurazione del proxy nel prompt dei comandi come segue:

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

• In generale, Django assume che per l’I/O venga usato l’encoding UTF-8. Questo può causare problemi se il tuo sistema è impostato per usare un encoding differente. Versioni recenti di Python permettono di impostare la variabile di ambiente PYTHONUTF8 per forzare l’encoding UTF-8. Windows 10 offre una impostazione a livello di sistema, spuntando Usa Unicode UTF-8 per il supporto alle lingue di tutto il mondo in Lingua ‣ Impostazioni di Amministrazione della Lingua ‣ Cambia il locale del sistema nelle impostazioni di sistema.