Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Visual Studio prend en charge la configuration de l’environnement de développement interactif (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 Options d’outils>. 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 Interactive Windows.
La boîte de dialogue Options répertorie d’autres paramètres Python sous Éditeur> de textePython. 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 sousPolices et couleurs de > pour le groupe de paramètres de l’Éditeur de texte.
Note
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
SousOptions>d’outils>Python, vous pouvez définir des options spécifiques à Python pour l’environnement général, notamment les environnements Windows interactifs, les environnements conda, le débogage, etc.
Options Python générales
Les options suivantes sont disponibles sousOptions>d’outils>Python>Général :
| Choix | Par défaut | Descriptif |
|---|---|---|
| Afficher la fenêtre Sortie lors de la création d’environnements virtuels | Activé | Désactivez cette option pour empêcher l’affichage de la fenêtre Sortie . |
| Afficher la fenêtre sortie lors de l’installation ou de la suppression de packages | Activé | Désactivez cette option pour empêcher l’affichage de la fenêtre Sortie . |
| Afficher la barre de notifications pour créer des environnements | Activé | Lorsque vous définissez et ouvrez un projet avec un fichier requirements.txt ou environment.yml , Visual Studio affiche une barre d’informations avec des suggestions pour créer un environnement virtuel ou un environnement conda, respectivement, au lieu d’utiliser l’environnement global par défaut. |
| Afficher la barre de notifications pour installer des packages | Activé | Lorsque vous définissez et ouvrez un projet avec un fichier requirements.txt qui n’utilise pas l’environnement global par défaut), Visual Studio compare ces exigences aux packages 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 l’infrastructure 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’aucune infrastructure 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 | Toujours élever et effectuer des opérations de gestionnaire de pip install 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 tel que c :\Program Files. Dans cette invite, vous pouvez choisir de toujours élever la commande d’installation pour un seul environnement. Pour plus d’informations, consultez l’onglet Packages. |
Options d’environnement Conda
Les options suivantes sont disponibles sous Outils>Options>Python>Conda :
| Choix | Par défaut | Descriptif |
|---|---|---|
| Chemin d’accès exécutable Conda | (vide) | Spécifie un chemin exact vers l’exécutable conda.exe plutôt que de compter sur l’installation par défaut de Miniconda incluse dans la charge de travail Python. Si un autre chemin d’accès est fourni 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 Miniconda, ou souhaitez utiliser une distribution 32 bits plutôt que la distribution 64 bits par défaut. |
Options de débogage
Les options suivantes sont disponibles sous Outils>Options>Python>de débogage :
| Choix | Par défaut | Descriptif |
|---|---|---|
| Confirmer avant d'exécuter lorsque des erreurs sont présentes | Activé | Lorsque cette option est définie, Visual Studio vous invite à confirmer que vous souhaitez exécuter du code contenant des erreurs. Pour désactiver l’avertissement, désactivez cette option. |
|
Attendre l’entrée lorsque le processus se termine anormalement Attendre l’entrée lorsque le processus s’arrête normalement |
Activé (pour les 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 la fermer, quelle que soit la façon dont le programme se ferme. Pour supprimer cette invite et fermer automatiquement la fenêtre, désactivez l’une ou l’autre de ces options. |
| Sortie du programme Tee dans la fenêtre Debug Output | Activé | Affiche la sortie du programme dans une fenêtre de console distincte et dans la fenêtre Sortie de Visual Studio. Désactivez cette option pour afficher la sortie uniquement dans la fenêtre de console distincte. |
| Arrêt sur l’exception SystemExit ayant pour code de sortie zéro | Off | Si défini, arrête le débogueur sur cette exception. Lorsque tout est correct, le débogueur quitte sans interruption. |
| Activer le débogage de la bibliothèque standard Python | Off | Permet d’effectuer un pas à pas 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. |
| Afficher la valeur de retour de la fonction | Activé | Affiche les valeurs de retour de fonction dans la fenêtre Locals , puis pas à pas sur un appel de fonction dans le débogueur (F10) |
| Afficher les variables | Activé | Affiche quatre groupes de variables à afficher et comment mettre en forme l’affichage (Groupe, Masquer, Inline). - Classe : La valeur par défaut est « Group » - Protégé : la valeur par défaut est inline » - 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 :
| Choix | Par défaut | Descriptif |
|---|---|---|
| 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 de l'espace de travail et fichiers ouverts uniquement. |
| Niveau de journalisation | Informations | Spécifie le niveau de journalisation à effectuer par le serveur de langue. Les niveaux possibles de journalisation, dans un niveau croissant d’informations fournies, incluent l’erreur, l’avertissement, les informations et la trace. |
| Vérification de type | Off | Spécifie le niveau d’analyse de vérification de type à effectuer : - Désactivé : produire des diagnostics d'importations/variables non résolues, mais ne pas effectuer d'analyse de vérification de type - De base : Utiliser des règles non typées (toutes les règles sous le niveau Off) ainsi que des règles de vérification de type de base. - Strict : Utilisez toutes les règles de vérification de type au niveau de gravité d’erreur le plus élevé, y compris toutes les règles sous les niveaux Désactivé et De base |
| Format d’importation | Absolu | Définit le format par défaut lors de l’importation automatique de modules, y compris Absolu ou Relatif. |
| Chemin des 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 Typeshed personnalisés au lieu de la version intégré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. | Off | 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 corrections rapides, le remplissage 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 les 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 interactives Windows
Les options suivantes sont disponibles sous>Outils Options>Python>Interactive Windows :
| Choix | Par défaut | Descriptif |
|---|---|---|
| Scripts | n/a | Spécifie un dossier général pour les scripts de démarrage à appliquer à Interactive Windows 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. |
| Flèches haut/bas naviguent dans l’historique | Activé | Utilise les touches de direction pour parcourir l’historique dans la fenêtre interactive . Désactivez ce paramètre pour utiliser les touches de direction afin de naviguer dans la sortie de la fenêtre Interactive à la place. |
| Mode d’achèvement | Évaluer uniquement les expressions sans appels de fonction | Le processus de détermination des membres disponibles sur une expression dans la fenêtre interactive peut nécessiter l’évaluation de l’expression non terminée actuelle, ce qui peut entraîner des effets secondaires ou des fonctions appelées plusieurs fois. Le paramètre par défaut, Évaluez uniquement les expressions sans appels de fonction exclut les expressions qui apparaissent pour appeler une fonction, mais évalue d’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 les suggestions.
Évaluer toutes les expressions évalue l’expression complète pour obtenir des suggestions, quels que soient les effets secondaires. |
| Masquer les suggestions d’analyse statique | Off | Lorsqu’il est défini, affiche uniquement les suggestions obtenues en évaluant l’expression. Si elle est combinée avec la valeur du mode de complétionNe jamais évaluer les expressions, aucune complétion utile n’apparaît dans la fenêtre Interactive. |
Options de l’éditeur de texte pour Python
Sous Éditeur> de textePython, 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 dans Outils>Options>Éditeur de texte>Python>Général :
| Choix | Par défaut | Descriptif |
|---|---|---|
| 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 cette option est activée, pointer 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 positionner les commentaires à un point cohérent en regard de votre code. Le mode Espace virtuel est activé en mode Sélection de colonne . 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 l’éditeur> de texteTous les langages>général> Activer le paramètre globald’espace virtuel. Si le paramètre global n’est pas activé, cette option ne peut pas être activée au niveau du langage. |
| Retour à la ligne | Off | 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 les glyphes visuels pour l’encapsulage de mot | Off | Lorsque l’option Word wrap est activée, utilisez cette option afin d'afficher des glyphes visuels. |
| Numéros de ligne | Off | 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 d’URL en un clic | Activé | Lorsqu’un paramètre est défini, vous pouvez cliquer d'un simple clic sur une URL pour accéder à l’emplacement cible. |
| Barre de navigation | Off | 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 la barre de navigation du code>. |
| Achèvement automatique de l’accolade | Activé | Lorsque cette option est activée, Visual Studio ajoute automatiquement l’accolade fermante pour chaque accolade ouverte lorsque vous entrez du code. |
| Appliquer couper ou copier à des 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 la boîte de dialogue Options : Éditeur > de texte général.
Options avancées de l’éditeur Python
Les options suivantes sont disponibles sous> OutilsOptions>Éditeur> de textePython>Avancé :
| Choix | Par défaut | Descriptif |
|---|---|---|
| Suggestions d'importation automatique | Activé | Lorsqu’il est défini, Visual Studio propose des importations automatiques en achèvement. |
| Ajouter automatiquement des crochets pour les fonctions | Off | Lorsqu’il est défini, Visual Studio ajoute automatiquement des crochets pour les fonctions lorsque vous entrez du code dans l’éditeur. |
Options des Polices et des Couleurs
D'autres options Python sont disponibles sous Environnement>Polices et couleurs lorsque le groupe Éditeur de texte est défini sur Python :
Les noms des options Python sont tous préfixés par « Python » et sont explicites. La police par défaut pour tous les thèmes de couleurs de Visual Studio est Consolas, 10 points, normal (pas en 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.