Référence sur les onglets de la fenêtre Environnements PythonPython Environments window tabs reference

Pour ouvrir la fenêtre Environnements Python :To open the Python Environments window:

  • Sélectionnez la commande de menu Affichage > Other Windows (Autres fenêtres) > Environnements Python.Select the View > Other Windows > Python Environments menu command.
  • Cliquez avec le bouton droit sur le nœud Environnements Python d’un projet dans l’Explorateur de solutions, et sélectionnez Afficher tous les environnements Python.Right-click the Python Environments node for a project in Solution Explorer and select View All Python Environments

Si vous agrandissez suffisamment la fenêtre Environnements Python, ces options s’affichent sous forme d’onglets, sans doute plus pratiques à utiliser.If you expand the Python Environments window wide enough, these options are shown as tabs, which you may find more convenient to work with. Dans un souci de clarté, les onglets de cet article apparaissent dans l’affichage développé.For clarity, the tabs in this article are shown in the expanded view.

Affichage développé de la fenêtre Environnements Python

Onglet Vue d’ensembleOverview tab

Fournit des commandes et des informations de base pour l’environnement :Provides basic information and commands for the environment:

Onglet Vue d’ensemble, Environnements Python

CommandeCommand DescriptionDescription
Make this environment the default for new projects (Définir cet environnement par défaut pour les nouveaux projets)Make this environment the default for new projects Définit l’environnement actif, ce qui risque d’interrompre brièvement le fonctionnement de Visual Studio lors du chargement de la base de données IntelliSense.Sets the active environment, which may cause Visual Studio to briefly become non-responsive while it loads the IntelliSense database. Les environnements avec de nombreux packages peuvent être interrompus pendant plus longtemps.Environments with many packages may be non-responsive for longer.
Visit the distributor’s website (Visiter le site web du serveur de distribution)Visit the distributor's website Dans un navigateur, ouvre l’URL fournie par la distribution Python.Opens a browser to the URL provided by the Python distribution. Python 3.x, par exemple, accède à python.org.Python 3.x, for example, goes to python.org.
Ouvrir une fenêtre interactiveOpen interactive window Ouvre la fenêtre (REPL) interactive pour cet environnement au sein de Visual Studio, en appliquant tous les scripts de démarrage (voir ci-dessous).Opens the interactive (REPL) window for this environment within Visual Studio, applying any startup scripts (see below).
Explorer les scripts interactifsExplore interactive scripts Consultez Scripts de démarrage.See startup scripts.
Utiliser le mode interactif IPythonUse IPython interactive mode Quand cette option est définie, ouvre la fenêtre interactive avec IPython par défaut.When set, opens the interactive window with IPython by default. Cela permet d’activer les tracés inline ainsi que la syntaxe IPython étendue comme name? pour afficher l’aide et !command pour les commandes de l’interpréteur de commandes.This enabled inline plots as well as the extended IPython syntax such as name? to view help and !command for shell commands. Cette option est recommandée lors de l’utilisation d’une distribution Anaconda, car elle nécessite des packages supplémentaires.This option is recommended when using an Anaconda distribution, as it requires extra packages. Pour plus d’informations, consultez Utilisation d’IPython dans la fenêtre interactive.For more information, see Using IPython in the Interactive Window.
Ouvrir dans PowerShellOpen in PowerShell Démarre l’interpréteur dans une fenêtre Commande PowerShell.Starts the interpreter in a PowerShell command window.
(Liens du dossier et du programme)(Folder and program links) Vous fournissent un accès rapide au dossier d’installation de l’environnement, à l’interpréteur python.exe et à l’interpréteur pythonw.exe.Provide you quick access to the environment's installation folder, the python.exe interpreter, and the pythonw.exe interpreter. Le premier s’ouvre dans l’Explorateur Windows et les deux autres ouvrent une fenêtre de console.The first opens in Windows Explorer, the latter two open a console window.

Scripts de démarrageStartup scripts

Quand vous utilisez des fenêtres interactives dans votre flux de travail quotidien, vous développez probablement des fonctions d’assistance que vous utilisez régulièrement.As you use interactive windows in your everyday workflow, you likely develop helper functions that you use regularly. Par exemple, vous pouvez créer une fonction qui ouvre une tramedonnées dans Excel, puis enregistrer ce code comme un script de démarrage afin qu’il soit toujours disponible dans la fenêtre interactive.For example, you may create a function that opens a DataFrame in Excel, and then save that code as a startup script so that it's always available in the interactive window.

Les scripts de démarrage contiennent du code que la fenêtre interactive charge et exécute automatiquement, dont les importations, les définitions de fonctions et, littéralement, tout autre élément.Startup scripts contain code that the interactive window loads and runs automatically, including imports, function definitions, and literally anything else. Ces scripts sont référencés de deux manières :Such scripts are referenced in two ways:

  1. Quand vous installez un environnement, Visual Studio crée un dossier Documents\Visual Studio 2017\Python Scripts\<environment> où <environnement> correspond au nom de l’environnement.When you install an environment, Visual Studio creates a folder Documents\Visual Studio 2017\Python Scripts\<environment> where <environment> matches the name of the environment. Vous pouvez facilement accéder au dossier spécifique à l’environnement avec la commande Explorer les scripts interactifs.You can easily navigate to the environment-specific folder with the Explore interactive scripts command. Quand vous démarrez la fenêtre interactive pour cet environnement, elle charge et exécute tous les fichiers .py qui s’y trouvent dans l’ordre alphabétique.When you start the interactive window for that environment, it loads and runs whatever .py files are found here in alphabetical order.

  2. Le contrôle Scripts dans l’onglet Outils > Options > Python Tools > Fenêtres interactives (consultez Options des fenêtres interactives) est destiné à spécifier un dossier supplémentaire pour les scripts de démarrage qui sont chargés et exécutés dans tous les environnements.The Scripts control in Tools > Options > Python Tools > Interactive Windows tab (see Interactive windows options) is intended to specify an additional folder for startup scripts that are loaded and run in all environments. Toutefois, cette fonctionnalité ne fonctionne pas actuellement.However, this feature doesn't work at present.

Onglet ConfigurerConfigure tab

S’il est disponible, il contient les informations décrites dans le tableau ci-dessous.If available, contains details as described in the table below. Si cet onglet n’est pas affiché, cela signifie que Visual Studio gère automatiquement toutes les informations.If this tab isn't present, it means that Visual Studio is managing all the details automatically.

Onglet Configurer, Environnements Python

ChampField DescriptionDescription
DescriptionDescription Le nom à donner à l’environnement.The name to give the environment.
Prefix path (Chemin du préfixe)Prefix path L’emplacement du dossier de base de l’interpréteur.The base folder location of the interpreter. En indiquant cette valeur et en cliquant sur Détecter automatiquement, Visual Studio tente de renseigner les autres champs pour vous.By filling this value and clicking Auto Detect, Visual Studio attempts to fill in the other fields for you.
Interpreter Path (Chemin d’interpréteur)Interpreter path Le chemin d’accès à l’interpréteur exécutable, généralement le chemin de préfixe suivi de python.exe.The path to the interpreter executable, commonly the prefix path followed by python.exe
Windowed interpreter (Interpréteur avec fenêtre)Windowed interpreter Le chemin d’accès à l’exécutable autre qu’une console, souvent le chemin de préfixe suivi de pythonw.exe.The path to the non-console executable, often the prefix path followed by pythonw.exe.
Chemin d’accès à la bibliothèqueLibrary path
(s’il est disponible)(if available)
Spécifie la racine de la bibliothèque standard, mais cette valeur peut être ignorée si Visual Studio est en mesure de demander un chemin d’accès plus précis à partir de l’interpréteur.Specifies the root of the standard library, but this value may be ignored if Visual Studio is able to request a more accurate path from the interpreter.
Version du langageLanguage version Sélectionnée à partir du menu déroulant.Selected from the drop-down menu.
ArchitectureArchitecture Normalement détectée et renseignée automatiquement, sinon, 32 bits ou 64 bits est spécifié.Normally detected and filled in automatically, otherwise specifies 32-bit or 64-bit.
Path environment variable (Variable d’environnement de chemin d’accès)Path environment variable La variable d’environnement que l’interpréteur utilise pour rechercher les chemins de recherche.The environment variable that the interpreter uses to find search paths. Visual Studio modifie la valeur de la variable lors du démarrage de Python pour qu’il contienne les chemins de recherche du projet.Visual Studio changes the value of the variable when starting Python so that it contains the project's search paths. En général, cette propriété doit être définie sur PYTHONPATH, mais certains interpréteurs utilisent une autre valeur.Typically this property should be set to PYTHONPATH, but some interpreters use a different value.

Onglet packagesPackages tab

Également appelé « pip » dans les versions antérieures.Also labeled "pip" in earlier versions.

Gère les packages installés dans l’environnement, ce qui vous permet également de rechercher des packages et d’en installer de nouveaux (y compris toutes les dépendances).Manages the packages installed in the environment, allowing you to also search for and install new ones (including any dependencies).

Les packages qui sont déjà installés apparaissent avec des contrôles pour mettre à jour (flèche vers le haut) et désinstaller (X dans un cercle) le package :Packages that are already installed appear with controls to update (an up arrow) and uninstall (the X in a circle) the package:

Onglet packages, Environnements Python

La saisie d’un terme de recherche filtre la liste des packages installés, ainsi que des packages qui peuvent être installés à partir de PyPI.Entering a search term filters the list of installed packages as well as packages that can be installed from PyPI.

Onglet packages, Environnements Python, avec recherche de « num »

En outre, vous pouvez entrer directement une commande pip install dans la zone de recherche, y compris les indicateurs tels que --user ou --no-deps.You can also directly enter any pip install command in the search box, including flags such as --user or --no-deps.

L’installation d’un package crée des sous-dossiers au sein du dossier Lib de l’environnement sur le système de fichiers.Installing a package creates subfolders within the environment's Lib folder on the file system. Par exemple, si Python 3.6 est installé dans c:\Python36, les packages sont installés dans c:\Python36\Lib ; si Anaconda 3 est installé dans c:\Program Files\Anaconda3, les packages sont installés dans c:\Program Files\Anaconda3\Lib.For example, if you have Python 3.6 installed in c:\Python36, packages are installed in c:\Python36\Lib; if you have Anaconda3 installed in c:\Program Files\Anaconda3 then packages are installed in c:\Program Files\Anaconda3\Lib.

Dans le dernier cas, étant donné que l’environnement se trouve dans une zone protégée du système de fichiers, c:\Program Files, Visual Studio doit exécuter une pip install avec élévation de privilèges pour lui permettre de créer des sous-dossiers de package.In the latter case, because the environment is located in a protected area of the file system, c:\Program Files, Visual Studio must run pip install elevated to allow it to create package subfolders. Quand une élévation est requise, Visual Studio affiche l’invite « Des privilèges d’administrateur peuvent être nécessaires pour installer, mettre à jour ou supprimer des packages pour cet environnement. » :When elevation is required, Visual Studio displays the prompt, "Administrator privileges may be required to install, update or remove packages for this environment":

Invite d’élévation pour l’installation de packages

Élever les privilèges maintenant accorde des privilèges d’administrateur à pip pour une seule opération, pouvant aussi faire l’objet d’une demande d’autorisations du système d’exploitation.Elevate now grants administrative privileges to pip for a single operation, subject also to any operating system prompts for permissions. En sélectionnant Continuer sans privilège d’administrateur, une tentative d’installation du package est effectuée, mais pip échoue en essayant de créer des dossiers avec une sortie telle que « Erreur. Impossible de créer 'C:\Program Files\Anaconda3\Lib\site-packages\png.py' : Autorisation refusée. ».Selecting Continue without Administrator privileges attempts to install the package, but pip fails when trying to create folders with output such as "error: could not create 'C:\Program Files\Anaconda3\Lib\site-packages\png.py': Permission denied."

En sélectionnant Toujours élever les privilèges pour l’installation et la suppression des packages, vous empêchez la boîte de dialogue de s’afficher pour l’environnement en question.Selecting Always elevate when installing or removing packages prevents the dialog from appearing for the environment in question. Pour que la boîte de dialogue s’affiche à nouveau, accédez à Outils > Options > Python Tools > Général et sélectionnez le bouton Réinitialiser toutes les boîtes de dialogue masquées définitivement.To make the dialog appear again, go to Tools > Options > Python Tools > General and select the button, Reset all permanently hidden dialogs.

Dans ce même onglet d’options, vous pouvez également sélectionner Toujours exécuter pip comme administrateur pour supprimer la boîte de dialogue pour tous les environnements.In that same options tab, you can also select Always run pip as administrator to suppress the dialog for all environments. Consultez Options - Onglet Général.See Options - General tab.

Onglet IntelliSenseIntelliSense tab

Affiche l’état actuel de la base de données de saisie semi-automatique IntelliSense :Shows the current status of the IntelliSense completion database:

Onglet IntelliSense, Environnements Python

Dans Visual Studio 2017 version 15.5 et versions précédentes, les saisies semi-automatiques IntelliSense dépendent d’une base de données qui a été compilée pour cette bibliothèque.In Visual Studio 2017 version 15.5 and earlier, IntelliSense completions depend on a database that's been compiled for that library. La génération de la base de données est effectuée en arrière-plan quand une bibliothèque est installée, mais peut prendre du temps et ne pas être terminée lorsque vous démarrez l’écriture de code.Building the database is done in the background when a library is installed, but can take some time and may not be complete when you start writing code. Visual Studio 2017 versions 15.6 et ultérieures utilise une méthode plus rapide pour fournir des saisies semi-automatiques qui ne dépendent pas de la base de données, sauf si vous choisissez spécifiquement de l’activer.Visual Studio 2017 version 15.6 and later uses a faster method to provide completions that do not depend on the database unless you specifically choose to enable it.

Lorsque Visual Studio détecte un nouvel environnement (ou que vous en ajoutez un), il commence automatiquement à compiler la base de données en analysant les fichiers source de la bibliothèque.When Visual Studio detects a new environment (or you add one), it automatically begins to compile the database by analyzing the library source files. Ce processus peut prendre entre une minute et plus d’une heure, selon ce qui est installé.This process can take anywhere from a minute to an hour or more depending on what's installed. (Anaconda, par exemple, est fourni avec de nombreuses bibliothèques et la compilation de la base de données prend un certain temps). Une fois ce processus terminé, vous obtenez la base de données IntelliSense détaillée et n’avez pas à actualiser une nouvelle fois la base de données (avec le bouton Refresh DB (Actualiser base de données)) jusqu’à ce que vous installiez d’autres bibliothèques.(Anaconda, for example, comes with many libraries and takes some time to compile the database.) Once complete, you get detailed IntelliSense and don't need to refresh the database again (with the Refresh DB button) until you install more libraries.

Les bibliothèques pour lesquelles les données n’ont pas été compilées sont marquées d’un ! ; si la base de données d’un environnement n’est pas complète, un !Libraries for which data haven't been compiled are marked with a !; if an environment's database isn't complete, a ! apparaît également en regard de celle-ci dans la liste principale des environnements.also appears next to it in the main environment list.

Voir aussiSee also