This document will guide you through installing Python 3.14 and Django on\nWindows. It also provides instructions for setting up a virtual environment,\nwhich makes it easier to work on Python projects. This is meant as a beginner’s\nguide for users working on Django projects and does not reflect how Django\nshould be installed when developing changes for Django itself.
\nI 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.
\nDjango is a Python web framework, thus requiring Python to be installed on your\nmachine. At the time of writing, Python 3.14 is the latest version.
\nPer 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».
\nAfter installation, open the command prompt and check that the Python version\nmatches the version you installed by executing:
\n...\\> py --version\npipLink to this heading#pip is a package manager for Python and is included by default with the\nPython installer. It helps to install and uninstall Python packages\n(such as Django!). For the rest of the installation, we’ll use pip to\ninstall Python packages from the command line.
È 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.
\nTo create a virtual environment for your project, open a new command prompt,\nnavigate to the folder where you want to create your project and then enter the\nfollowing:
\n...\\> py -m venv project-name\nThis will create a folder called “project-name” if it does not already exist\nand set up the virtual environment. To activate the environment, run:
\n...\\> project-name\\Scripts\\activate.bat\nL’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.
\nDjango puo essere installato utilizzando pip nel tuo ambiente virtuale.
In the command prompt, ensure your virtual environment is active, and execute\nthe following command:
\n...\\> py -m pip install Django\nQuesto scarichera e installera l’ultima versione di Django
\nDopo 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.
\nUna 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\ninstalled to enable syntax coloring:
\n...\\> py -m pip install "colorama >= 0.4.6"\nVedere Syntax coloring per ulteriori informazioni sulle impostazioni del colore.
\nSe 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.
If you are connecting to the internet behind a proxy, there might be problems\nin running the command py -m pip install Django. Set the environment\nvariables for proxy configuration in the command prompt as follows:
...\\> set http_proxy=http://username:password@proxyserver:proxyport\n...\\> set https_proxy=https://username:password@proxyserver:proxyport\nIn 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 nelle impostazioni di sistema.