Options pour Python dans Visual StudioOptions for Python in Visual Studio

Pour afficher les options relatives à 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 sous l’onglet Éditeur de texte > Python > Avancé, ainsi que sous l’onglet Environnement > Polices et couleurs dans le 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. Au moment de l’installation 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 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 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 des enquêtes/actualitésCheck 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 enquêtes et des actualités liées à Python, le cas échéant.Sets the frequency at which you allow Visual Studio to 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.
Bouton Réinitialiser toutes les boîtes de dialogue masquées définitivementReset 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.
Bouton Enregistrer le diagnostic dans un fichierSave 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.
Bouton Copier le diagnostic dans le Presse-papiersCopy 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 > Fenêtres interactives.)(Tools > Options > Python > Interactive Windows tab.)

OptionOption Par défautDefault DescriptionDescription
ScriptsScripts 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 permettent de naviguer dans l’historiqueUp/down arrows navigate history ActivéOn Utilise les touches de direction pour naviguer dans l’historique de la fenêtre Interactive.Uses the arrow keys to navigate through history in the Interactive window. Désactivez ce paramètre afin d’utiliser les touches de direction pour 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 inachevée, 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. 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.If combined with the Completion mode value 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 complétions dans la fenêtre de l’éditeur et la fenêtre Interactive.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;^~=<>#@\{}.,:;+-*/%&&#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 permet de choisir et d’appliquer la complétion 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 si vous appuyez sur Entrée, vous validez cette complétion.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 de manière effective les complétions quand vous avez fini de taper l’identificateur. Ainsi, Entrée permet d’insérer 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 dans le groupe Éditeur de texte.)(Environment > Fonts and Colors tab within the Text Editor group.)

Les noms des options Python sont toutes précédées de 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