Options pour Python dans Visual Studio

Visual Studio prend en charge la configuration de l’environnement de développement intégré (IDE) pour le développement Python. Vous pouvez définir des options en fonction de vos préférences et répondre aux besoins spécifiques de l’environnement de développement. Cet article décrit les options disponibles pour la disposition et le comportement généraux, le débogage, les diagnostics et les fonctionnalités avancées du langage Python.

Emplacement des options Python

Les paramètres de configuration Python sont disponibles à partir de la barre d’outils de Visual Studio sous Outils>Options. La boîte de dialogue Options répertorie la plupart des paramètres pour Python sous l’onglet Python :

Vous pouvez configurer des préférences pour le débogage, l’analyse du serveur de langage Pylance, les environnements conda, l’environnement général et les fenêtres interactives.

La boîte de dialogue Options répertorie d’autres paramètres Python sous Éditeur de texte>Python. Il existe des options pour les barres de défilement, les onglets et la mise en forme, ainsi que les paramètres généraux et avancés. D'autres paramètres sont disponibles sous Polices et couleurs>de l'environnement pour le groupe de paramètres de l'éditeur de texte.

Remarque

La boîte de dialogue Options peut inclure un onglet expérimental ou un groupe pour les fonctionnalités en cours de développement qui ne sont pas décrites dans cet article. Vous trouverez plus d’informations dans les billets sur l’ingénierie Python sur le blog Microsoft.

Options spécifiques pour Python

Sous Outils>Options>Python, vous pouvez définir des options spécifiques à Python pour l’environnement général, notamment les environnements de fenêtres interactives, les environnements conda, le débogage, etc.

Options Python générales

Les options suivantes sont disponibles sous Outils>Options>Python>Général :

Option	Default	Description
Afficher la fenêtre Sortie pendant la création d’environnements virtuels	Activé	Désactivez-la pour empêcher la fenêtre Sortie de s’afficher.
Afficher la fenêtre Sortie pendant l’installation ou la suppression des packages	Activé	Désactivez-la pour empêcher la fenêtre Sortie de s’afficher.
Afficher la barre de notification pour créer des environnements	Activé	Lorsque cette option est activée et que vous ouvrez un projet contenant un fichier requirements.txt ou environment.yml, Visual Studio affiche une barre d'information proposant de créer un environnement virtuel ou un environnement conda, respectivement, au lieu d'utiliser l'environnement global par défaut.
Afficher la barre de notification pour installer des packages	Activé	Lorsqu'il est défini et que vous ouvrez un projet avec un fichier requirements.txt qui n'utilise pas l'environnement global par défaut, Visual Studio compare ces exigences avec les paquets installés dans l'environnement actuel. Si des packages sont manquants, Visual Studio affiche une invite pour installer ces dépendances.
Afficher la barre de notifications pour configurer le framework de test	Activé	Lorsque cette option est définie, si Visual Studio détecte des fichiers dans votre projet Python qui peuvent contenir des tests, mais qu’aucun framework de test n’est activée, Visual Studio vous invite à activer pytest ou unittest.
Toujours exécuter des Gestionnaires de package en tant qu’administrateur	Off	Élève toujours les privilèges de pip install et d’opérations de gestionnaire de package similaires pour tous les environnements. Lorsque vous installez des packages, Visual Studio demande des privilèges d’administrateur, si l’environnement se trouve dans une zone protégée du système de fichiers, par exemple Fichiers c:\Program. Dans cette invite, vous pouvez choisir de toujours élever les privilèges de la commande d’installation pour cet environnement uniquement. Pour plus d’informations, consultez l’onglet Paquets.

Options d’environnement Conda

Les options suivantes sont disponibles sous Outils>Options>Python>Conda :

Option	Default	Description
Chemin de l’exécutable Conda	(vide)	Spécifie un chemin d’accès exact à l’exécutable conda.exe au lieu de compter sur l’installation Miniconda par défaut fournie avec la charge de travail Python. Si un autre chemin d’accès est indiqué ici, il est prioritaire sur l’installation par défaut et les autres exécutables conda.exe spécifiés dans le Registre. Vous pouvez modifier ce paramètre si vous installez manuellement une version plus récente d’Anaconda ou de Miniconda, ou si vous souhaitez utiliser une distribution 32 bits au lieu de la distribution 64 bits par défaut.

Options de débogage

Les options suivantes sont disponibles sous Outils>Options>Python>Débogage :

Option	Default	Description
Demander avant d’exécuter en présence d’erreurs	Activé	Lorsque cette option est activée, Visual Studio vous invite à confirmer que vous souhaitez exécuter du code contenant des erreurs. Supprimez cette option pour désactiver l’avertissement.
Attendre une entrée quand le processus quitte de manière inhabituelle Attendre une entrée quand le processus quitte de manière habituelle	Activées (toutes deux)	Un programme Python démarré à partir de Visual Studio s’exécute dans sa propre fenêtre de console. Par défaut, la fenêtre attend que vous appuyiez sur une touche avant de se fermer, quelle que soit la façon dont le programme se termine. Pour supprimer cette invite et fermer la fenêtre automatiquement, désactivez l’une de ces options, ou les deux.
Sortie du programme Tee dans la fenêtre Sortie du débogage	Activé	Affiche la sortie du programme dans une fenêtre de console distincte et la fenêtre Sortie de Visual Studio. Désactivez cette option pour afficher la sortie uniquement dans la fenêtre de console distincte.
Arrêter en cas d’exception SystemExit avec le code de sortie zéro	Off	Si cette option est définie, arrête le débogueur sur cette exception. Quand elle est désactivée, le débogueur se ferme sans s’arrêter.
Activer le débogage de la bibliothèque Python standard	Off	Permet d’effectuer un pas à pas détaillé dans le code source de la bibliothèque standard pendant le débogage, mais augmente le temps nécessaire au démarrage du débogueur.
Montrer la valeur de retour de la fonction	Activé	Affiche les valeurs renvoyées de fonction dans la fenêtre Variables locales lors du survol d’un appel de fonction dans le débogueur (F10)
Afficher des variables	Activé	Affiche quatre groupes de variables à afficher et comment mettre en forme l’affichage (Groupe, Masquer, En ligne). - Classe : la valeur par défaut est « Groupe » - Protégé : la valeur par défaut est en ligne » - Fonction : la valeur par défaut est « Groupe » - Spécial : la valeur par défaut est « Groupe »

Options d’analyse

Les options suivantes sont disponibles sous Outils>Options>Python>Analyse :

Option	Default	Description
Mode de diagnostic	Ouvrir des fichiers uniquement	Spécifie les fichiers de code que le serveur de langage analyse pour les problèmes, y compris les fichiers d’espace de travail et d’ouverture uniquement.
Niveau de journalisation	Information	Spécifie le niveau de journalisation à effectuer par le serveur de langage. Les niveaux possibles de journalisation, dans un niveau croissant d’informations fournies, incluent l’erreur, l’avertissement, les informations et la trace.
Contrôle de type	Désactivé	Spécifie le niveau d’analyse de contrôle de type à effectuer : - Désactivé : produit des diagnostics sur les importations/variables non résolues, mais n’effectue pas d’analyse de contrôle de type - Basique : utilise des règles non typiques (toutes les règles sous le niveau Désactivé) et également les règles de base liées au contrôle de type - Strict : utilise toutes les règles de contrôle de type au niveau d’erreur le plus élevé, y compris toutes les règles sur les niveaux Désactivé et Basique
Format d'importation	Absolute	Définit le format par défaut lors de l’importation automatique de modules, y compris Absolu ou Relatif.
Chemin d'accès stubs	<Vide>	Spécifie un chemin d'accès à un répertoire qui contient des stubs de type personnalisé. Les fichiers stub de type pour chaque package sont censés se trouver dans leur propre sous-répertoire.
Chemins de recherche	<Vide>	Spécifie les chemins de recherche pour la résolution d’importation. Accepte les chemins spécifiés en tant que chaînes et séparés par des virgules s’il existe plusieurs chemins, tels que ["path 1","path 2"].
Chemins d'accès typés	<Vide>	Spécifie les chemins d'accès de Visual Studio pour utiliser des fichiers typés personnalisés au lieu de sa version groupée.
Ajouter automatiquement des chemins de recherche courants comme « src »	Activé	Indique s’il faut ajouter automatiquement des chemins de recherche basés sur des noms prédéfinis, tels que src.
Index installé des bibliothèques tierces et des fichiers utilisateur pour les fonctionnalités linguistiques telles que l’importation automatique, l’ajout d’importation, les symboles d’espace de travail et etc.	Désactivé	Spécifie si le serveur de langage doit indexer les fichiers utilisateur et installer des bibliothèques tierces au démarrage. L’index fournit un ensemble plus complet de symboles dans les fonctionnalités, notamment les importations automatiques, les correctifs rapides, la saisie semi-automatique, etc. - Lorsqu’il est défini, Visual Studio indexe les symboles de niveau supérieur des packages installés, tels que les symboles dans tous sous package/__init__.py, ainsi que tous les symboles d’un maximum de 2 000 fichiers utilisateur. - Lorsqu’il n’est pas défini, Visual Studio affiche les symboles référencés ou utilisés dans les fichiers précédemment ouverts ou chargés par l’éditeur.

Options des fenêtres interactives

Les options suivantes sont disponibles sous Outils>Options>Python>Fenêtres interactives :

Option	Default	Description
Scripts	n/a	Spécifie un dossier général pour les scripts de démarrage à appliquer aux fenêtres interactives pour tous les environnements. Pour plus d’informations, consultez Scripts de démarrage. Remarque : cette fonctionnalité peut ne pas fonctionner dans votre version de Visual Studio.
Les flèches Haut/Bas explorent l’historique	Activé	Utilise les touches de direction pour naviguer dans l’historique de la fenêtre Interactive. Désactivez ce paramètre afin d’utiliser les touches de direction pour naviguer dans la sortie de la fenêtre Interactive à la place.
Mode de saisie semi-automatique	Évaluer uniquement les expressions sans appel de fonction	Le processus permettant de déterminer les membres disponibles sur une expression dans la fenêtre Interactive pourrait nécessiter l’évaluation de l’expression inachevée, ce qui peut aboutir à des effets secondaires ou des fonctions appelées à plusieurs reprises. Le paramètre par défaut, Évaluer uniquement les expressions sans appel de fonction, exclut les expressions qui apparaissent pour appeler une fonction, mais évalue les autres expressions. Par exemple, il évalue l’instruction a.b, mais pas l’instruction a().b. Ne jamais évaluer les expressions empêche tous les effets secondaires, en utilisant uniquement le moteur IntelliSense normal pour obtenir des suggestions. Évaluer toutes les expressions évalue l’expression complète pour obtenir des suggestions, indépendamment des effets secondaires.
Masquer les suggestions d’analyse statique	Off	Quand cette option est définie, n’affiche que les suggestions obtenues en évaluant l’expression. Si cette option est associée à la valeur Ne jamais évaluer les expressions de l’option Mode de saisie semi-automatique, aucune saisie semi-automatique utile ne s’affiche dans la fenêtre Interactive.

Options de l’éditeur de texte pour Python

Sous Éditeur de texte>Python, il existe des options pour les barres de défilement, les onglets et la mise en forme, ainsi que les paramètres généraux et avancés :

Options générales de l’éditeur Python

Les options suivantes sont disponibles sous Outils>Options>Éditeur de texte>Python>Général :

Option	Default	Description
Répertorier automatiquement les membres	Activé	Définissez cette option pour répertorier automatiquement les membres pour l’achèvement des instructions de code.
Masquer les membres avancés	Activé	Lorsque l’option Membres de liste automatique est activée, définissez cette option pour masquer les membres avancés des suggestions de saisie semi-automatique. Les membres avancés sont des membres qui sont utilisés moins fréquemment que d’autres.
Informations sur les paramètres	Activé	Lorsque vous définissez, le pointage sur les paramètres affiche des informations détaillées, telles que la définition de l’élément et des liens vers la documentation.
Activer l'espace virtuel	Activé	En cas de définition, insère des espaces à la fin de chaque ligne de code. Sélectionnez cette option pour placer des commentaires en un point précis, proche de votre code. Le mode Espace virtuel est activé dans le mode Sélectionner les colonnes. Lorsque le mode Espace virtuel n’est pas activé, le point d’insertion passe de la fin d’une ligne directement au premier caractère de la ligne suivante. Remarque : cette option est influencée par le paramètre global Éditeur de texte>Toutes les langues>Général>Activer l'espace virtuel. Si le paramètre global n’est pas activé, cette option ne peut pas être activée au niveau du langage.
Retour automatique à la ligne	Désactivé	Définissez cette option pour autoriser les lignes longues de code à encapsuler en fonction de la largeur de la fenêtre d’affichage des éditeurs.
Afficher des glyphes visuels pour le retour automatique à la ligne	Désactivé	Lorsque l’option retour automatique à la ligne est activée, définissez cette option pour afficher les glyphes visuels.
Numéros de ligne	Désactivé	Définissez cette option pour afficher les numéros de ligne dans la marge gauche de l’éditeur pour chaque ligne de code.
Activer la navigation dans les URL par simple clic	Activé	Lorsque vous définissez, vous pouvez cliquer sur une URL pour accéder à l’emplacement cible.
Barre de navigation	Désactivé	Définissez cette option pour activer les zones de liste déroulante en haut de la fenêtre de code. Ces champs vous aident à accéder au code dans une base de code dans laquelle vous pouvez choisir un type ou un membre pour accéder directement à. Remarque : cette option est influencée par le paramètre global Éditeur de texte>Toutes les langues>Général>Activer la barre de navigation. Pour plus d’informations, consultez Naviguer dans le code> Barre de navigation.
Fin d'accolade automatique	Activé	Lorsqu’il est défini, Visual Studio ajoute automatiquement l’accolade fermante pour n’importe quelle accolade ouverte lorsque vous entrez du code.
Appliquer Couper ou Copier aux lignes vides en l'absence de sélection	Activé	Par défaut, Visual Studio coupe ou copie toute la ligne de code lorsqu’il n’y a pas de sélection explicite. Utilisez cette option pour activer ou désactiver ce comportement couper ou copier lorsqu’elle est appelée sur des lignes vides.

Pour plus d’informations, consultez Boîte de dialogue Options : Éditeur de texte > Général.

Options avancées de l’éditeur Python

Les options suivantes sont disponibles sous Outils>Options>Éditeur de texte>Python>Avancé :

Option	Default	Description
Saisie semi-automatique de l’offre	Activé	Lorsqu’il est défini, Visual Studio propose des importations automatiques en achèvement.
Ajouter automatiquement des crochets pour les fonctions	Désactivé	Lorsqu’il est défini, Visual Studio ajoute automatiquement des crochets pour les fonctions lorsque vous entrez du code dans l’éditeur.

Options Polices et couleurs

D'autres options Python sont disponibles sous Polices et couleurs>de l'environnement lorsque le groupe Éditeur de texte est défini sur Python :

Les noms des options Python ont toutes le préfixe « Python » et sont explicites. La police par défaut de tous les thèmes de couleurs Visual Studio est 10 pt Consolas regular (non gras). Les couleurs par défaut varient selon le thème. En règle générale, vous modifiez une police ou une couleur pour faciliter la lecture du texte.