{"title":"Comment installer Django avec Windows","version":"5.1","locale":"fr","docname":"howto/windows","url":"/fr/5.1/howto/windows/","canonical":"https://djangodocs.dev/fr/5.1/howto/windows/","summary":"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…","html":"<h1>Comment installer Django avec Windows<a class=\"heading-anchor\" href=\"#how-to-install-django-on-windows\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>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.</p>\n<p>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.</p>\n<section id=\"install-python\">\n<span id=\"install-python-windows\"></span><h2>Installation de Python<a class=\"heading-anchor\" href=\"#install-python\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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.</p>\n<p>Pour installer Python sur votre machine, visitez <a class=\"reference external\" href=\"https://www.python.org/downloads/\">https://www.python.org/downloads/</a>. 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 ».</p>\n<p>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 :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py --version\n</code></pre></div>\n<aside class=\"admonition-py-is-not-recognized-or-found admonition\">\n<p class=\"admonition-title\"><code class=\"docutils literal notranslate\"><span class=\"pre\">py</span></code> n’est pas reconnu, ni trouvé</p>\n<p>En fonction de la façon dont Python a été installé (par ex. via le Store Microsoft), il se peut que <code class=\"docutils literal notranslate\"><span class=\"pre\">py</span></code> ne soit pas disponible dans l’invite de commande.</p>\n<p>Il faudra alors utiliser  <code class=\"docutils literal notranslate\"><span class=\"pre\">python</span></code> au lieu de <code class=\"docutils literal notranslate\"><span class=\"pre\">py</span></code> lors de la saisie des commandes.</p>\n</aside>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">Voir aussi</p>\n<p>Pour plus de détails, lisez la documentation <a class=\"reference external\" href=\"https://docs.python.org/3/using/windows.html\" title=\"(disponible dans Python v3.14)\"><span>Using Python on Windows</span></a>.</p>\n</aside>\n</section>\n<section id=\"about-pip\">\n<h2>À propos de <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code><a class=\"heading-anchor\" href=\"#about-pip\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><a class=\"extlink-pypi reference external\" href=\"https://pypi.org/project/pip/\">pip</a> 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 <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> pour installer des paquets Python à partir de la ligne de commande.</p>\n</section>\n<section id=\"setting-up-a-virtual-environment\">\n<span id=\"virtualenvironment\"></span><h2>Configuration d’un environnement virtuel<a class=\"heading-anchor\" href=\"#setting-up-a-virtual-environment\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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 <a class=\"reference external\" href=\"https://packaging.python.org/guides/tool-recommendations/\">documentation de Python</a>. Python lui-même contient <a class=\"reference external\" href=\"https://docs.python.org/3/tutorial/venv.html\" title=\"(disponible dans Python v3.14)\"><span class=\"xref std std-doc\">venv</span></a> pour la gestion des environnements et c’est celui que nous allons utiliser dans ce guide.</p>\n<p>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 :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m venv project-name\n</code></pre></div>\n<p>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 :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> project-name\\Scripts\\activate.bat\n</code></pre></div>\n<p>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.</p>\n</section>\n<section id=\"install-django\">\n<h2>Installation de Django<a class=\"heading-anchor\" href=\"#install-django\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django peut être installé facilement en utilisant <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> dans votre environnement virtuel.</p>\n<p>Dans l’invite de commande, vérifiez que l’environnement virtuel est actif et exécutez la commande suivante :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install Django\n</code></pre></div>\n<p>Ceci va télécharger et installer la dernière version de Django.</p>\n<p>À la fin de l’installation, vous pouvez contrôler que tout s’est bien déroulé en exécutant <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span> <span class=\"pre\">--version</span></code> dans l’invite de commande.</p>\n<p>Consultez <a class=\"reference internal\" href=\"/fr/5.1/topics/install/#database-installation\"><span class=\"std std-ref\">Mise en route de la base de données</span></a> pour plus d’informations sur l’installation de bases de données avec Django.</p>\n</section>\n<section id=\"colored-terminal-output\">\n<h2>Sortie de terminal colorée<a class=\"heading-anchor\" href=\"#colored-terminal-output\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>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 <span class=\"target\" id=\"index-4\"></span><a class=\"reference internal\" href=\"/fr/5.1/ref/django-admin/#envvar-DJANGO_COLORS\"><code class=\"xref std std-envvar docutils literal notranslate\"><span class=\"pre\">DJANGO_COLORS</span></code></a> à <code class=\"docutils literal notranslate\"><span class=\"pre\">nocolor</span></code>.</p>\n<p>Sur les anciennes versions de Windows ou d’anciens terminaux, <a class=\"extlink-pypi reference external\" href=\"https://pypi.org/project/colorama/\">colorama</a> 0.4.6+ doit être installé pour activer la syntaxe colorée :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install <span class=\"s2\">&quot;colorama &gt;= 0.4.6&quot;</span>\n</code></pre></div>\n<p>Voir <a class=\"reference internal\" href=\"/fr/5.1/ref/django-admin/#syntax-coloring\"><span class=\"std std-ref\">Syntaxe colorée</span></a> pour plus d’informations sur les réglages de couleur.</p>\n</section>\n<section id=\"common-pitfalls\">\n<h2>Problèmes fréquents<a class=\"heading-anchor\" href=\"#common-pitfalls\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<ul>\n<li><p>Si <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span></code> 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 <code class=\"docutils literal notranslate\"><span class=\"pre\">PATH</span></code>. Cela se produit généralement lorsqu’il y a plusieurs versions de Python installées.</p></li>\n<li><p>Si vous passez par un serveur mandataire (proxy) pour vous connecter à Internet, il peut y avoir des problèmes lorsque vous lancez la commande <code class=\"docutils literal notranslate\"><span class=\"pre\">py</span> <span class=\"pre\">-m</span> <span class=\"pre\">pip</span> <span class=\"pre\">install</span> <span class=\"pre\">Django</span></code>. Définissez les variables d’environnement de configuration du serveur mandataire dans l’invite de commande, comme ceci :</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">http_proxy</span><span class=\"p\">=</span>http://username:password@proxyserver:proxyport\n<span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">https_proxy</span><span class=\"p\">=</span>https://username:password@proxyserver:proxyport\n</code></pre></div>\n</li>\n<li><p>En général, Django suppose que les entrées/sorties utilisent le codage  <code class=\"docutils literal notranslate\"><span class=\"pre\">UTF-8</span></code>. 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 <span class=\"target\" id=\"index-5\"></span><a class=\"reference external\" href=\"https://docs.python.org/3/using/cmdline.html#envvar-PYTHONUTF8\" title=\"(disponible dans Python v3.14)\"><code class=\"xref std std-envvar docutils literal notranslate\"><span class=\"pre\">PYTHONUTF8</span></code></a> afin de forcer le codage en <code class=\"docutils literal notranslate\"><span class=\"pre\">UTF-8</span></code>. Windows 10 propose aussi un réglage système que l’on peut activer en cochant <code class=\"docutils literal notranslate\"><span class=\"pre\">Utiliser</span> <span class=\"pre\">Unicode</span> <span class=\"pre\">UTF-8</span> <span class=\"pre\">pour</span> <span class=\"pre\">la</span> <span class=\"pre\">prise</span> <span class=\"pre\">en</span> <span class=\"pre\">charge</span> <span class=\"pre\">universelle</span> <span class=\"pre\">des</span> <span class=\"pre\">langues</span></code> dans <span class=\"menuselection\">Langue ‣ Réglages d’administration des langues ‣ Modifier la locale système</span> dans les réglages système.</p></li>\n</ul>\n</section>","rootId":"how-to-install-django-on-windows","toc":[{"title":"Installation de Python","anchor":"install-python","children":[]},{"title":"À propos de pip","anchor":"about-pip","children":[]},{"title":"Configuration d’un environnement virtuel","anchor":"setting-up-a-virtual-environment","children":[]},{"title":"Installation de Django","anchor":"install-django","children":[]},{"title":"Sortie de terminal colorée","anchor":"colored-terminal-output","children":[]},{"title":"Problèmes fréquents","anchor":"common-pitfalls","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Guides pratiques","url":"/fr/5.1/howto/"}],"prev":{"docname":"howto/upgrade-version","title":"Mise à jour de Django à une version plus récente","url":"/fr/5.1/howto/upgrade-version/"},"next":{"docname":"howto/deployment/index","title":"Comment déployer Django","url":"/fr/5.1/howto/deployment/"},"formats":{"html":"/fr/5.1/howto/windows/","markdown":"/fr/5.1/howto/windows.md","json":"/fr/5.1/howto/windows.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/howto/windows.txt","official":"https://docs.djangoproject.com/fr/5.1/howto/windows/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}