Partager via


Configurer votre environnement de développement Python sur Windows

Préparez votre environnement Python sur Windows en quelques minutes : configurez-le manuellement ou automatisez tout avec winget. Vous devez disposer des éléments suivants :

  • Python 3.13 : le dernier runtime Python
  • Visual Studio Code – Éditeur de code léger et puissant
  • Extension Python pour Visual Studio Code : ajoute la prise en charge du langage Python, le débogage, le linting et bien plus encore

Le fichier de configuration WinGet ci-dessous installe tous les éléments répertoriés ci-dessus automatiquement.

Pour commencer :

  1. Ouvrez PowerShell dans le terminal Windows et exécutez la commande suivante :

    winget configure -f https://aka.ms/python-config
    
  2. Au démarrage de la configuration, une fenêtre de terminal affiche les étapes d’installation et les installations requises. Vérifiez-les, puis confirmez en sélectionnant [Y] Oui ou [N] Non pour continuer.

  3. Les charges de travail requises sont installées. Vérifiez votre configuration en exécutant python --version.

Vous êtes maintenant prêt pour le développement Python.

Questions fréquentes

Problèmes d’installation d’un package avec l’installation pip

Il existe plusieurs raisons pour lesquelles une installation échouera dans de nombreux cas, la bonne solution consiste à contacter le développeur du package.

Une cause courante de problèmes est d’essayer d’installer dans un emplacement que vous n’avez pas l’autorisation de modifier. Par exemple, l’emplacement d’installation par défaut peut nécessiter des privilèges d’administration, mais par défaut, Python ne les aura pas. La meilleure solution consiste à créer un environnement virtuel et à y installer.

Certains packages incluent du code natif qui nécessite l’installation d’un compilateur C ou C++. En règle générale, les développeurs de packages doivent publier des versions précompilées, mais ce n’est souvent pas le cas. Certains de ces packages peuvent fonctionner si vous installez Build Tools pour Visual Studio et sélectionnez l’option C++. Toutefois, dans la plupart des cas, vous devrez contacter le développeur de packages.

Suivez la discussion sur StackOverflow

Problèmes d’installation de pip avec WSL

Lors de l’installation d’un package (comme Flask) avec pip sur le sous-système Windows pour Linux (WSL ou WSL2), par exemple python3 -m pip install flask, vous pouvez rencontrer une erreur semblable à celle-ci :

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection
object at 0x7f655471da30>: Failed to establish a new connection: [Errno -3]
Temporary failure in name resolution')': /simple/flask/

Sauf si vous exécutez un pare-feu aftermarket, la solution probable consiste simplement à réinstaller pip :

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
Qu’est-ce que py.exe?

Vous pouvez finir avec plusieurs versions de Python installées sur votre machine, car vous travaillez sur différents types de projets Python. Étant donné que toutes utilisent la python commande, il peut ne pas être évident quelle version de Python vous utilisez. En tant que norme, il est recommandé d’utiliser la python3 commande (ou python3.7 de sélectionner une version spécifique).

Le lanceurpy.exe sélectionne automatiquement la version la plus récente de Python que vous avez installée. Vous pouvez également utiliser des commandes telles que py -3.7 pour sélectionner une version particulière ou py --list pour voir quelles versions peuvent être utilisées. TOUTEFOIS, le lanceur py.exe fonctionne uniquement si vous utilisez une version de Python installée à partir de python.org. Lorsque vous installez Python à partir du Microsoft Store, la py commande n’est pas incluse. Pour Linux, macOS, WSL et la version du Microsoft Store de Python, vous devez utiliser la python3 commande (ou python3.7) .

Pourquoi l’exécution de python.exe ouvre-t-elle le Microsoft Store ?

Pour aider les nouveaux utilisateurs à trouver une bonne installation de Python, nous avons ajouté un raccourci vers Windows qui vous emmènera directement vers la dernière version du package de la communauté publiée dans le Microsoft Store. Ce package peut être installé facilement, sans autorisations d’administrateur, et remplacera les commandes par défaut python et python3 les commandes réelles.

L’exécution de l’exécutable de raccourci avec tous les arguments de ligne de commande retourne un code d’erreur pour indiquer que Python n’a pas été installé. Cela permet d’empêcher l’ouverture des fichiers et des scripts par lots de l’application Store lorsqu’elle n’a probablement pas été prévue.

Si vous installez Python à l’aide des programmes d’installation à partir de python.org et sélectionnez l’option « Ajouter à PATH », la nouvelle python commande prend la priorité sur le raccourci. Notez que d’autres programmes d’installation peuvent ajouter python à une priorité inférieure à celle du raccourci intégré.

Vous pouvez désactiver les raccourcis sans installer Python en ouvrant « Gérer les alias d’exécution d’application » à partir de l’écran de démarrage, en recherchant les entrées Python « Programme d’installation d’application » et en les basculant vers « Désactivé ».

Pourquoi les chemins de fichiers ne fonctionnent-ils pas en Python après les avoir copiés-collés ?

Les chaînes Python utilisent des « échappements » pour des caractères spéciaux. Par exemple, pour insérer un nouveau caractère de ligne dans une chaîne, vous devez taper \n. Étant donné que les chemins d’accès aux fichiers sur Windows utilisent des barres obliques inverses, certaines parties peuvent être converties en caractères spéciaux.

Pour coller un chemin sous forme de chaîne dans Python, ajoutez le r préfixe. Cela indique qu’il s’agit d’une raw chaîne et qu’aucun caractère d’échappement n’est utilisé à l’exception de « (vous devrez peut-être supprimer la dernière barre oblique inverse dans votre chemin). Votre chemin d’accès peut donc ressembler à ceci : r"C:\Users\MyName\Documents\Document.txt"

Lorsque vous utilisez des chemins d’accès dans Python, nous vous recommandons d’utiliser le module pathlib standard. Cela vous permet de convertir la chaîne en un objet Path enrichi qui peut effectuer des manipulations de chemin de manière cohérente, qu'il utilise des barres obliques avant ou des barres obliques arrière, permettant d'améliorer l'efficacité de votre code sur différents systèmes d’exploitation.

Qu’est-ce que PYTHONPATH ?

La variable d’environnement PYTHONPATH est utilisée par Python pour spécifier une liste de répertoires à partir duquel les modules peuvent être importés. Lors de l’exécution, vous pouvez inspecter la sys.path variable pour voir quels répertoires seront recherchés lorsque vous importez quelque chose.

Pour définir cette variable à partir de l’invite de commandes, utilisez : set PYTHONPATH=list;of;paths.

Pour définir cette variable à partir de PowerShell, utilisez : $env:PYTHONPATH='list;of;paths' juste avant de lancer Python.

La définition globale de cette variable via les paramètres des variables d’environnementn’est pas recommandée, car elle peut être utilisée par n’importe quelle version de Python au lieu de celle que vous envisagez d’utiliser.

Où puis-je trouver de l’aide sur l’empaquetage et le déploiement ?

Docker : l’extension VSCode vous permet de empaqueter et de déployer rapidement avec dockerfile et des modèles docker-compose.yml (générer les fichiers Docker appropriés pour votre projet).

Azure Kubernetes Service (AKS) vous permet de déployer et de gérer des applications conteneurisées tout en mettant à l’échelle les ressources à la demande.

Que se passe-t-il si j’ai besoin de travailler sur différents ordinateurs ?

La synchronisation des paramètres vous permet de synchroniser vos paramètres VS Code entre différentes installations à l’aide de GitHub. Si vous travaillez sur différents ordinateurs, cela permet de maintenir la cohérence de votre environnement entre eux.

Que faire si j'ai l'habitude d'utiliser PyCharm, Atom, Sublime Text, Emacs ou Vim ?

Les keymaps d’extension VSCode peuvent aider votre environnement à se sentir à la maison.

Comment les touches de raccourci Mac sont-elles mappées aux touches de raccourci Windows ?

Certains boutons clavier et raccourcis système sont légèrement différents entre une machine Windows et un Macintosh. Ce guide de transition Mac vers Windows couvre les principes de base.

Où puis-je en savoir plus sur l’utilisation de Python dans VS Code ?
  • Modification de Python dans VS Code : découvrez comment tirer parti de la saisie semi-automatique et de la prise en charge d’IntelliSense de VS Code pour Python, notamment comment personnaliser leur comportement... ou simplement les désactiver.
  • Linting Python : Linting est le processus d’exécution d’un programme qui analyse le code pour les erreurs potentielles. Découvrez les différentes formes de prise en charge du linting que VS Code propose pour Python et comment les configurer.
  • Débogage python : le débogage est le processus d’identification et de suppression d’erreurs d’un programme informatique. Cet article explique comment initialiser et configurer le débogage pour Python avec VS Code, comment définir et valider des points d’arrêt, attacher un script local, effectuer le débogage pour différents types d’applications ou sur un ordinateur distant et résoudre des problèmes de base.
  • Python de test unitaire : couvre un arrière-plan expliquant ce que signifie le test unitaire, un exemple de procédure pas à pas, l’activation d’une infrastructure de test, la création et l’exécution de vos tests, des tests de débogage et des paramètres de configuration de test.