Comment installer Django avec Windows¶
This document will guide you through installing Python 3.13 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.
Les étapes de ce guide ont été testées avec Windows 10. Avec d’autres versions, les instructions devraient être similaires. Vous devez être à l’aise avec l’utilisation de l’invite de commandes de Windows.
Installation de Python¶
Django is a Python web framework, thus requiring Python to be installed on your machine. At the time of writing, Python 3.13 is the latest version.
Pour installer Python sur votre machine, visitez https://www.python.org/downloads/. Ce site devrait vous proposer un bouton de téléchargement pour la dernière version de Python. Téléchargez l’exécutable d’installation et lancez-le. Cochez les cases « Install launcher for all users (recommended) » puis cliquez sur « Installer maintenant ».
Après l’installation, ouvrez l’invite de commande et vérifiez que la version de Python correspond à celle que vous avez installée en exécutant :
...\> py --version
py
n’est pas reconnu, ni trouvé
En fonction de la façon dont Python a été installé (par ex. via le Store Microsoft), il se peut que py
ne soit pas disponible dans l’invite de commande.
Il faudra alors utiliser python
au lieu de py
lors de la saisie des commandes.
Voir aussi
Pour plus de détails, lisez la documentation Using Python on Windows.
À propos de pip
¶
pip est un gestionnaire de paquets pour Python et il est inclus par défaut dans l’installeur Python. Il aide à installer et désinstaller des paquets Python (tels que Django !). Pour le reste de l’installation, nous utiliserons pip
pour installer des paquets Python à partir de la ligne de commande.
Configuration d’un environnement virtuel¶
Une bonne pratique reconnue est de définir un environnement dédié pour chaque projet Django que vous créez. Il existe de nombreuses options pour gérer les environnements et les paquets dans l’écosystème Python, dont certains sont recommandés dans la documentation de Python. Python lui-même contient venv pour la gestion des environnements et c’est celui que nous allons utiliser dans ce guide.
Pour créer un environnement virtuel pour votre projet, ouvrez une nouvelle invite de commande et placez-vous dans le dossier dans lequel vous souhaitez créer le projet, puis saisissez ce qui suit :
...\> py -m venv project-name
Cela va créer un dossier nommé « project-name » s’il n’existe pas déjà et va configurer l’environnement virtuel. Pour activer l’environnement, exécutez :
...\> project-name\Scripts\activate.bat
L’environnement virtuel sera activé et vous verrez « (nom-du-projet) » à côté de l’invite de commande pour vous en convaincre. Chaque fois que vous lancez une nouvelle invite de commande, vous devrez activer à nouveau l’environnement.
Installation de Django¶
Django peut être installé facilement en utilisant pip
dans votre environnement virtuel.
Dans l’invite de commande, vérifiez que l’environnement virtuel est actif et exécutez la commande suivante :
...\> py -m pip install Django
Ceci va télécharger et installer la dernière version de Django.
À la fin de l’installation, vous pouvez contrôler que tout s’est bien déroulé en exécutant django-admin --version
dans l’invite de commande.
Consultez Mise en route de la base de données pour plus d’informations sur l’installation de bases de données avec Django.
Sortie de terminal colorée¶
Une fonctionnalité très appréciable affiche du contenu coloré dans le terminal. Avec les terminaux modernes, cela doit fonctionner aussi bien avec CMD que PowerShell. Si pour une raison quelconque ceci doit être désactivé, définissez la variable d’environnement DJANGO_COLORS
à nocolor
.
Sur les anciennes versions de Windows ou d’anciens terminaux, colorama 0.4.6+ doit être installé pour activer la syntaxe colorée :
...\> py -m pip install "colorama >= 0.4.6"
Voir Syntaxe colorée pour plus d’informations sur les réglages de couleur.
Problèmes fréquents¶
Si
django-admin
n’affiche que le texte d’aide quels que soient les paramètres indiqués, il y a probablement un problème avec les associations de fichiers dans Windows. Contrôlez s’il y a plus d’une variable d’environnement définie pour l’exécution de scripts Python dansPATH
. Cela se produit généralement lorsqu’il y a plusieurs versions de Python installées.Si vous passez par un serveur mandataire (proxy) pour vous connecter à Internet, il peut y avoir des problèmes lorsque vous lancez la commande
py -m pip install Django
. Définissez les variables d’environnement de configuration du serveur mandataire dans l’invite de commande, comme ceci :...\> set http_proxy=http://username:password@proxyserver:proxyport ...\> set https_proxy=https://username:password@proxyserver:proxyport
En général, Django suppose que les entrées/sorties utilisent le codage
UTF-8
. Cela peut être problématique si votre système est configuré pour utiliser un autre codage. Les versions récentes de Python permettent de définir la variable d’environnementPYTHONUTF8
afin de forcer le codage enUTF-8
. Windows 10 propose aussi un réglage système que l’on peut activer en cochantUtiliser Unicode UTF-8 pour la prise en charge universelle des langues
dans dans les réglages système.