Options pour Python dans Visual StudioOptions for Python in Visual Studio

Pour afficher les options pour Python, utilisez la commande de menu Outils > Options, vérifiez que la case Afficher tous les paramètres est cochée, puis accédez à Python Tools :To view Python options, use the Tools > Options menu command, make sure Show all settings is selected, and then navigate to Python Tools:

Boîte de dialogue Options pour Python, onglet Général

Il existe également des options supplémentaires spécifiques à Python dans l’onglet Éditeur de texte > Python > Avancé et dans l’onglet Environnement > Polices et couleurs au sein du groupe « Éditeur de texte ».There are also additional Python-specific options on the Text Editor > Python > Advanced tab, and on the Environment > Fonts and Colors tab within the "Text Editor" group.

Note

Le groupe Expérimental contient des options pour des fonctionnalités encore en cours de développement qui ne sont pas décrites ici.The Experimental group contains options for features that are still under development and are not documented here. Celles-ci sont souvent décrites dans les posts du blog sur l’ingénierie Python chez Microsoft.They are often discussed in posts on the Python engineering at Microsoft blog.

Options généralesGeneral options

(Onglet Outils > Options > Python.)(Tools > Options > Python tab.)

OptionOption Par défautDefault DescriptionDescription
Afficher la fenêtre Sortie pendant la création d’environnements virtuelsShow the Output Window when creating virtual environments ActivéOn Désactivez-la pour empêcher la fenêtre Sortie de s’afficher.Clear to prevent the output window from appearing.
Afficher la fenêtre Sortie pendant l’installation ou la suppression des packagesShow the Output Window when installing or removing packages ActivéOn Désactivez-la pour empêcher la fenêtre Sortie de s’afficher.Clear to prevent the output window from appearing.
Toujours exécuter pip comme administrateurAlways run pip as administrator OffOff Élève toujours les privilèges des opérations pip install pour tous les environnements.Always elevates pip install operations for all environments. Lors de l’installation des packages, Visual Studio vous invite à entrer des privilèges d’administrateur si l’environnement se trouve dans une zone protégée du système de fichiers, par exemple c:\Program Files.When installing packages, Visual Studio prompts for administrator privileges if the environment is located in a protected area of the file system such as c:\Program Files. Dans cette invite, vous pouvez choisir de toujours élever les privilèges de pip install pour cet environnement uniquement.In that prompt you can choose to always elevate pip install for just that one environment. Consultez l’onglet packages.See packages tab.
Générer automatiquement la base de données de saisie semi-automatique à la première utilisationAutomatically generate completion DB on first use ActivéOn S’applique à Visual Studio 2017 version 15.5, versions antérieures et versions ultérieures lorsque vous utilisez une base de données IntelliSense.Applies to Visual Studio 2017 version 15.5 and earlier and to later versions when using an IntelliSense database. Donne la priorité à l’achèvement de la base de données pour une bibliothèque quand vous écrivez du code qui l’utilise.Prioritizes completion of the database for a library when you write code that uses it. Pour plus d’informations, consultez Référence sur la fenêtre Environnements - onglet Intellisense.For more information, see Environments window reference - Intellisense tab.
Ignorer les variables PYTHONPATH à l’échelle du systèmeIgnore system-wide PYTHONPATH variables ActivéOn PYTHONPATH est ignoré par défaut, car Visual Studio fournit un moyen plus direct de spécifier des chemins de recherche dans les projets et environnements.PYTHONPATH is ignored by default because Visual Studio provides a more direct means to specify search paths in environments and projects. Consultez la page Chemins de recherche pour plus d’informations.See Search paths for details.
Mettre à jour les chemins de recherche lors de l’ajout de fichiers liésUpdate search paths when adding linked files ActivéOn Quand cette option est définie, l’ajout d’un fichier lié à un projet met à jour les Chemins de recherche afin qu’IntelliSense puisse inclure le contenu du dossier du fichier lié dans sa base de données de saisie semi-automatique.When set, adding a linked file to a project updates Search paths so that IntelliSense can include the contents of the linked file's folder in its completion database. Désactivez cette option pour exclure ce contenu de la base de données de saisie semi-automatique.Clear this option to exclude such content from the completion database.
Avertir quand le module importé est introuvableWarn when imported module cannot be found ActivéOn Désactivez cette option pour supprimer les avertissements quand vous savez qu’un module importé n’est actuellement pas disponible, mais n’affecte pas par ailleurs le fonctionnement du code.Clear this option to suppress warnings when you know an imported module isn't presently available but doesn't otherwise affect code operation.
Signaler une indentation incohérente commeReport inconsistent indentation as AvertissementsWarnings Comme l’interpréteur Python dépend fortement d’une mise en retrait appropriée pour déterminer la portée, Visual Studio émet par défaut des avertissements quand il détecte des mises en retrait incohérentes pouvant indiquer des erreurs de codage.Because the Python interpreter depends heavily on proper indentation to determine scope, Visual Studio by default issues warnings when it detects inconsistent indentations that might indicate coding errors. Option définie sur Erreurs pour être encore plus stricte, ce qui entraîne la fermeture du programme dans ces cas.Set to Errors to be even more strict, which causes the program to exit in such cases. Pour désactiver complètement ce comportement, sélectionnez Ne pas le faire.To disable this behavior altogether, select Don't.
Rechercher une étude/actualitéCheck for survey/news Une fois par semaineOnce a week Définit la fréquence à laquelle vous permettez à Visual Studio d’ouvrir une fenêtre contenant une page web avec des nouveautés et des études liées à Python, le cas échéant.Sets the frequency at which you allow Visual Studio can open a window containing a web page with Python-related surveys and news items, if available. Les options sont Jamais, Une fois par jour, Une fois par semaine et Une fois par mois.Options are Never, Once a day, Once a week, and Once a month.
Réinitialiser toutes les boîtes de dialogue masquées définitivement (bouton)Reset all permanently hidden dialogs (button) N/An/a Différentes boîtes de dialogue fournissent des options telles que Ne plus afficher ce message.Different dialog boxes provide options such as Don't show me this again. Utilisez ce bouton pour effacer ces options et entraîner le retour des boîtes de dialogue.Use this button to clear those options and cause the dialogs to reappear.

Boîte de dialogue Options pour Python, onglet Général

Options de débogageDebugging options

(Onglet Outils > Options > Python > Débogage.)(Tools > Options > Python > Debugging tab.)

OptionOption Par défautDefault DescriptionDescription
Demander avant d’exécuter en présence d’erreursPrompt before running when errors are present ActivéOn Quand cette option est définie, vous êtes invité à confirmer que vous souhaitez exécuter le code qui contient des erreurs.When set, prompts you to confirm that you want to run code that contains errors. Désactivez cette option pour désactiver l’avertissement.Clear this option to disable the warning.
Attendre une entrée quand le processus quitte de manière inhabituelleWait for input when process exits abnormally

Attendre une entrée quand le processus quitte de manière habituelleWait for input when process exits normally
Activées (toutes deux)On (for both) Un programme Python démarré à partir de Visual Studio s’exécute dans sa propre fenêtre de console.A Python program started from Visual Studio runs in its own console window. 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.By default, the window waits for you to press a key before closing it regardless of how the program exits. Pour supprimer cette invite et fermer la fenêtre automatiquement, désactivez l’une de ces options, ou les deux.To remove that prompt and close the window automatically, clear either or both of these options.
Sortie du programme Tee dans la fenêtre Sortie du débogageTee program output to Debug Output window ActivéOn Affiche la sortie du programme dans une fenêtre de console distincte et la fenêtre Sortie de Visual Studio.Displays program output in both a separate console window and the Visual Studio Output window. Désactivez cette option pour afficher la sortie uniquement dans la fenêtre de console distincte.Clear this option to show output only in the separate console window.
Arrêter en cas d’exception SystemExit avec le code de sortie zéroBreak on SystemExit exception with exit code of zero OffOff Si cette option est définie, arrête le débogueur sur cette exception.If set, stops the debugger on this exception. Quand elle est désactivée, le débogueur se ferme sans s’arrêter.When clear, the debugger exits without breaking.
Activer le débogage de la bibliothèque Python standardEnable debugging of the Python standard library OffOff 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.Makes it possible to step into the standard library source code while debugging, but increases the time it takes for the debugger to start.

Boîte de dialogue Options pour Python, onglet Débogage

Options des diagnosticsDiagnostics options

(Onglet Outils > Options > Python > Diagnostics.)(Tools > Options > Python > Diagnostics tab.)

OptionOption Par défautDefault DescriptionDescription
Inclure les journaux d’analyseInclude analysis logs ActivéOn Inclut des journaux détaillés relatifs à l’analyse des environnements Python installés lors de l’enregistrement des diagnostics dans un fichier ou en les copiant dans le Presse-papiers à l’aide des boutons.Includes detailed logs relating to analysis of installed Python environments when saving diagnostics to a file or copying them to the clipboard using the buttons. Cette option peut augmenter considérablement la taille du fichier généré, mais elle est souvent nécessaire pour diagnostiquer les problèmes IntelliSense.This option may significantly increase the size of the generated file, but is often required to diagnose IntelliSense issues.
Enregistrer les diagnostics dans un fichier (bouton)Save diagnostics to file (button) N/An/a Demande un nom de fichier, puis enregistre le journal dans un fichier texte.Prompts for a filename, then saves the log to a text file.
Copier les diagnostics dans le Presse-papiers (bouton)Copy diagnostics to clipboard (button) N/An/a Copie l’intégralité du journal dans le Presse-papiers ; cette opération peut prendre un certain temps, en fonction de la taille du journal.Places the entirety of the log on the clipboard; this operation may take some time depending on the size of the log.

Boîte de dialogue Options pour Python, onglet Diagnostics

Options des fenêtres interactivesInteractive Windows options

(Onglet Outils > Options > Python > Windows Interactive.)(Tools > Options > Python > Interactive Windows tab.)

OptionOption Par défautDefault DescriptionDescription
scripts ;Scripts N/An/a Spécifie un dossier général pour les scripts de démarrage à appliquer aux fenêtres interactives pour tous les environnements.Specifies a general folder for startup scripts to apply to interactive windows for all environments. Consultez Scripts de démarrage.See Startup scripts. Notez, toutefois, que cette fonctionnalité ne fonctionne pas pour l’instant.Note, however, that this feature does not currently work.
Les flèches Haut/Bas explorent l’historiqueUp/down arrows navigate history ActivéOn Utilise les touches de direction pour parcourir l’historique dans la fenêtre interactive.Uses the arrow keys to navigate through history in the interactive window. Désactivez ce paramètre pour utiliser les touches de direction afin de naviguer dans la sortie de la fenêtre interactive à la place.Clear this setting to use the arrow keys to navigate within the interactive window's output instead.
Mode de saisie semi-automatiqueCompletion mode Évaluer uniquement les expressions sans appel de fonctionOnly evaluate expressions without function calls Le processus permettant de déterminer les 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 aboutir à des effets secondaires ou des fonctions appelées à plusieurs reprises.The process of determining the available members on an expression in the interactive window may require evaluating the current unfinished expression, which can result in side-effects or functions being called multiple times. 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.The default setting, Only evaluate expressions without function calls excludes expressions that appear to call a function, but evaluates other expressions. Par exemple, il évalue a.b mais pas a().b.For example, it evaluates a.b but not a().b. Ne jamais évaluer les expressions empêche tous les effets secondaires, en utilisant uniquement le moteur IntelliSense normal pour obtenir des suggestions.Never evaluate expressions prevents all side-effects, using only the normal IntelliSense engine for suggestions. Évaluer toutes les expressions évalue l’expression complète pour obtenir des suggestions, indépendamment des effets secondaires.Evaluate all expressions evaluates the complete expression to obtain suggestions, regardless of side effects.
Masquer les suggestions d’analyse statiqueHide static analysis suggestions OffOff Quand cette option est définie, n’affiche que les suggestions obtenues en évaluant l’expression.When set, displays only suggestions that are obtained by evaluating the expression. Associée au mode de saisie semi-automatique Ne jamais évaluer les expressions, aucune saisie semi-automatique utile ne s’affiche dans la fenêtre interactive.If combined with the Completion mode Never evaluate expressions, no useful completions appear in the interactive window.

Boîte de dialogue Options pour Python, onglet Fenêtres interactives

Options avancées de l’éditeur PythonAdvanced Python editor options

(Onglet Outils > Options > Éditeur de texte > Python > Avancé.)(Tools > Options > Text Editor > Python > Advanced tab.)

Résultats de la saisie semi-automatiqueCompletion Results

OptionOption Par défautDefault DescriptionDescription
La saisie semi-automatique des membres affiche l’intersection des membresMember completion displays intersection of members OffOff Quand cette option est définie, affiche uniquement les saisies semi-automatiques qui sont prises en charge par tous les types possibles.When set, shows only completions that are supported by all possible types.
Liste de filtres basée sur une chaîne de rechercheFilter list based on search string ActivéOn Applique le filtrage des suggestions de saisie semi-automatique quand vous tapez (activée par défaut).Applies filtering of completion suggestions as you type (default is checked).
Afficher automatiquement la saisie semi-automatique pour tous les identificateursAutomatically show completions for all identifiers ActivéOn Désactivez cette option pour désactiver les saisies semi-automatiques dans l’éditeur et les fenêtres interactives.Clear this option to disable completions in both the editor and interactive windows.

Sélection dans la liste de saisie semi-automatiqueSelection in Completion List

OptionOption Par défautDefault DescriptionDescription
Validé en tapant les caractères suivantsCommitted by typing the following characters {}[]().,:;+-*/%&&#124;^~=<>#@\ Comme ces caractères suivent généralement un identificateur qui peut être sélectionné dans une liste de saisie semi-automatique, il est pratique de valider la saisie semi-automatique simplement en tapant un caractère.These characters typically follow an identifier that one might select from a completion list, so it's convenient to commit the completion simply by typing a character. Vous pouvez supprimer ou ajouter des caractères spécifiques dans la liste si vous le souhaitez.You can remove or add specific characters to the list as desired.
Entrée valide la saisie semi-automatique actuelleEnter commits current completion ActivéOn Quand cette option est définie, la touche Entrée choisit et applique la saisie semi-automatique sélectionnée comme avec les caractères ci-dessus (mais, bien entendu, il n’existe pas de caractère pour la touche Entrée pouvant être intégré directement dans cette liste !).When set, the Enter key chooses and applies the currently selected completion as with the characters above (but of course, there isn't a character for Enter so it couldn't go into that list directly!).
Ajouter une ligne avec entrée après le mot complet tapéAdd new line on enter at end of fully typed word OffOff Par défaut, si vous tapez le mot entier qui s’affiche dans la fenêtre contextuelle de saisie semi-automatique et appuyez sur Entrée, vous validez cette saisie.By default, if you type the entire word that appears in the completion popup and press Enter, you commit that completion. En définissant cette option, vous validez effectivement les saisies semi-automatiques quand vous avez fini de taper l’identificateur, de sorte qu’Entrée insère une nouvelle ligne.By setting this option, you effectively commit completions when you finish typing the identifier, such that Enter inserts a new line.

Options diversesMiscellaneous Options

OptionOption Par défautDefault DescriptionDescription
Passer en mode Plan à l'ouverture des fichiersEnter outlining mode when files open ActivéOn Activez automatiquement la fonctionnalité de mode Plan de Visual Studio dans l’éditeur lors de l’ouverture d’un fichier de code Python.Automatically turn on Visual Studio's outlining feature in the editor when opening a Python code file.
Le collage supprime les invites REPLPaste removed REPL prompts ActivéOn Supprime >>> et ... du texte collé, ce qui permet de transférer facilement le code de la fenêtre interactive vers l’éditeur.Removes >>> and ... from pasted text, allowing easy transfer of code from the interactive window to the editor. Désactivez cette option si vous devez conserver ces caractères lors du collage à partir d’autres sources.Clear this option if you need to retain those characters when pasting from other sources.
Noms de couleur basés sur les typesColor names based on types ActivéOn Active les couleurs de syntaxe dans le code Python.Enables syntax coloring in Python code.

Boîte de dialogue Options de l’éditeur Python, onglet Avancé

Options Polices et couleursFonts and Colors options

(Onglet Environnement > Polices et couleurs au sein du groupe « Éditeur de texte ».)(Environment > Fonts and Colors tab within the "Text Editor" group.)

Les noms des options Python ont toutes le préfixe « Python » et sont explicites.The names of the Python options are all prefixed with "Python" and are self-explanatory. La police par défaut pour tous les thèmes de couleurs Visual Studio est 10 pt Consolas regular (non gras).The default font for all Visual Studio color themes is 10pt Consolas regular (not bold). Les couleurs par défaut varient selon le thème.The default colors vary by theme. En règle générale, vous modifiez une police ou une couleur si vous la lecture du texte est difficile avec les paramètres par défaut.Typically, you change a font or color if you find it difficult to read text with the default settings.

Options de police et de couleur Python