Come installare Django su Windows¶
This document will guide you through installing Python 3.12 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.
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 is a Python web framework, thus requiring Python to be installed on your machine. At the time of writing, Python 3.12 is the latest version.
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».
After installation, open the command prompt and check that the Python version matches the version you installed by executing:
...\> py --version
Vedi anche
Per maggiori dettagli, vedere la documentazione Using Python on Windows.
Su 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.
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.
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 set up the virtual environment. To activate the environment, run:
...\> 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.
In the command prompt, ensure your virtual environment is active, and execute the following command:
...\> 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
.
On older Windows versions, or legacy terminals, colorama 0.4.6+ must be installed to enable syntax coloring:
...\> py -m pip install "colorama >= 0.4.6"
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 inPATH
. Questo generalmente accade quando c’è più di una versione di Python installata.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
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 ambientePYTHONUTF8
per forzare l’encodingUTF-8
. Windows 10 offre una impostazione a livello di sistema, spuntandoUsa Unicode UTF-8 per il supporto alle lingue di tutto il mondo
in nelle impostazioni di sistema.