Tutoriels · 9 min de lecture

Guide de survie : Configurer VS Code et Python sous Windows 11 comme un pro

Par Alexandre Vandevelde, Enseignant ·

Tutoriel étape par étape pour installer proprement Python sur Windows 11, configurer Visual Studio Code et éviter définitivement les pièges de variables d'environnement et le Microsoft Store.

C'est le premier grand défi technique de tout apprenti développeur : avant même d'écrire sa toute première ligne de code, il faut préparer son environnement de travail. Et soyons honnêtes : sous Windows 11, ce qui devrait être une simple formalité se transforme souvent en un véritable parcours du combattant. Entre la commande 'python' qui ouvre subitement le Microsoft Store, le terminal qui indique 'Commande introuvable', et les encodages de caractères qui plantent sur les accents, il y a de quoi se décourager. Ce guide est conçu pour vous accompagner pas à pas vers une installation propre, solide et professionnelle.

1. Étape 1 : Télécharger et installer Python (Le piège vital à éviter !)

Rendez-vous sur le site officiel python.org et téléchargez la dernière version stable pour Windows.

⚠️ ATTENTION : L'ÉTAPE CRITIQUE ⚠️

Lors de l'ouverture du fichier d'installation .exe, une fenêtre apparaît. Avant de cliquer sur 'Install Now', vous devez IMPÉRATIVEMENT COCHER LA CASE EN BAS DE PAGE :

[x] Add python.exe to PATH

Si vous oubliez de cocher cette case, Windows ne saura pas dans quel dossier se trouve l'exécutable Python, et votre terminal affichera systématiquement l'erreur 'python n'est pas reconnu comme une commande interne'.

À la fin de l'installation, cliquez également sur 'Disable path length limit' pour éviter les problèmes de chemins de fichiers trop longs sous Windows.

# Fenêtre d'installation de Python :
┌────────────────────────────────────────────────────────┐
│ Install Python 3.12 (64-bit)                           │
│                                                        │
│ [x] Use admin privileges when installing py.exe       │
│ [x] Add python.exe to PATH   <--- CACHE À COCHER ABSOLUMENT !│
└────────────────────────────────────────────────────────┘

2. Étape 2 : Résoudre le bug du 'Microsoft Store' qui s'ouvre tout seul

C'est le problème N°1 rencontré sous Windows 11. Lorsque vous tapez python dans votre terminal, Windows essaie d'ouvrir la page de téléchargement du Microsoft Store au lieu de lancer votre interpréteur Python.

Pour désactiver ce comportement indésirable :

1) Ouvrez le menu Démarrer de Windows 11 et tapez : 'Alias d'exécution d'applications' (App execution aliases).

2) Dans la liste qui s'affiche, localisez les deux lignes 'Installateur d'application - python.exe' et 'Installateur d'application - python3.exe'.

3) Basculez leurs interrupteurs sur DÉSACTIVÉ (Off).

Désormais, Windows utilisera uniquement le vrai Python installé !

3. Étape 3 : Installer et franciser Visual Studio Code

Téléchargez VS Code sur code.visualstudio.com. Lors de l'installation, assurez-vous de cocher la case 'Ajouter l'action Ouvrir avec Code au menu contextuel de Windows'. Cela vous permettra d'ouvrir n'importe quel dossier de projet d'un simple clic droit !

Si vous souhaitez traduire l'interface de VS Code en français :

  • Ouvrez VS Code, cliquez sur l'icône des carrés à gauche (Extensions ou Ctrl+Shift+X).
  • Cherchez French Language Pack et cliquez sur Install.

4. Étape 4 : Les 3 extensions indispensables pour coder en Python

Pour transformer VS Code en véritable studio de développement Python, installez ces 3 extensions incontournables dans l'onglet Extensions :

1) Python (par Microsoft) : apporte la coloration syntaxique et le support du langage.

2) Pylance (par Microsoft) : analyse votre code en temps réel et souligne les erreurs avant même l'exécution.

3) Jupyter (par Microsoft) : permet d'exécuter des Notebooks .ipynb directement au sein de VS Code.

5. Étape 5 : Créer et tester votre premier script

1) Créez un dossier vide sur votre bureau nommé mon_code.

2) Ouvrez ce dossier dans VS Code (Fichier -> Ouvrir le dossier).

3) Créez un nouveau fichier nommé app.py.

4) Écrivez la ligne de test ci-dessous et cliquez sur le petit bouton 'Play' ▶️ en haut à droite pour exécuter le code dans le terminal intégré !

# Votre premier script de test sous Windows 11
import sys

print("🎉 Félicitations !")
print(f"Python est parfaitement configuré sur votre machine version {sys.version.split()[0]}.")

À retenir

  • Cochez impérativement 'Add python.exe to PATH' lors de l'installation de Python.
  • Désactivez les alias du Microsoft Store dans les paramètres système de Windows 11.
  • Cochez 'Ouvrir avec Code' lors de l'installation de VS Code pour un accès rapide.
  • Installez l'extension 'Pylance' pour bénéficier de la détection d'erreurs en direct.

Articles liés

← Tous les articles