Comment installer Django avec Windows

Ce document vous guide dans l’installation de Python 3.13 et de Django pour Windows. Il fournit également des instructions de configuration d’un environnement virtuel qui facilite le travail sur des projets Python. L’objectif est d’en faire une introduction pour les utilisateurs travaillant sur des projets Django, et non pas de décrire la manière d’installer Django pour pouvoir développer des modifications pour Django lui-même.

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 est un applicatif Web pour Python, il nécessite donc que Python soit installé sur le système. Au moment de la rédaction de ce guide, Python 3.13 est la version la plus récente.

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 dans PATH. 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’environnement PYTHONUTF8 afin de forcer le codage en UTF-8. Windows 10 propose aussi un réglage système que l’on peut activer en cochant Utiliser Unicode UTF-8 pour la prise en charge universelle des langues dans Langue ‣ Réglages d’administration des langues ‣ Modifier la locale système dans les réglages système.