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 > 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, puis 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
Définir cet environnement par défaut pour les nouveaux projetsMake this environment the default for new projects Définit l’environnement actif, ce qui risque d’interrompre brièvement le fonctionnement de Visual Studio (2017 version 15.5 et antérieure) pendant le chargement de la base de données IntelliSense.Sets the active environment, which may cause Visual Studio (2017 version 15.5 and earlier) 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.
Visiter le site web du distributeurVisit 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 telle que name?pour afficher l’aide, et !command pour les commandes de l’interpréteur de commandes.This enables 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 Utiliser IPython dans la fenêtre interactive.For more information, see Use 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 un DataFrame dans Excel, puis vous pouvez enregistrer ce code en tant que script de démarrage pour 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, notamment 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\<environnement> 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 sous 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 Chemin de l’exécutable de l’interpréteur. En règle générale, il s’agit du chemin de préfixe suivi de python.exeThe path to the interpreter executable, commonly the prefix path followed by python.exe
Windowed interpreter (Interpréteur avec fenêtre)Windowed interpreter Chemin de l’exécutable qui n’est pas celui de la console. Bien souvent, il s’agit du 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 avoir la valeur 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 à l’aide de pip, 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 using pip, allowing you to also search for and install new ones (including any dependencies). Dans Visual Studio 2017 versions 15.7 et ultérieures, un onglet Packages (Conda) s’affiche et utilise le gestionnaire de package conda à la place.In Visual Studio 2017 version 15.7 and later, a Packages (Conda) tab appears which uses the conda package manager instead. (Si vous ne voyez pas ce choix, définissez l’option Outils > Options > Python > Expérimental > Utiliser le Gestionnaire de package Conda si disponible (au lieu de Pip) et redémarrez Visual Studio.)(If you don't see that choice, set the option Tools > Options > Python > Experimental > Use conda package manager when available (instead of pip) and restart Visual Studio.)

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 »

Comme vous pouvez le voir dans l’image ci-dessus, les résultats de la recherche affichent plusieurs packages qui correspondent au terme de recherche. Toutefois, la première entrée de la liste est une commande qui permet d’exécuter pip install <nom> directement.As you can see in the image above, the search results show a number of packages that match the search term; the first entry in the list, however, is a command to run pip install <name> directly. Si vous êtes sous l’onglet Packages (Conda), vous voyez plutôt conda install <nom> :If you're on the Packages (Conda) tab, you instead see conda install <name>:

Onglet de packages Conda montrant une commande d’installation conda

Dans les deux cas, vous pouvez personnaliser l’installation en ajoutant des arguments dans la zone de recherche après le nom du package.In both cases, you can customize the install by adding arguments in the search box after the name of the package. Quand vous incluez des arguments, les résultats de la recherche affichent pip install ou conda install suivi du contenu de la zone de recherche :When you include arguments, the search results shows pip install or conda install followed by the contents of the search box:

Utilisation d’arguments avec les commandes d’installation pip et conda

L’installation d’un package crée des sous-dossiers dans le 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 Anaconda3 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.

Octroyer des privilèges d’administrateur pour l’installation des packagesGrant administrator privileges for package install

Au moment d’installer des packages dans un environnement situé dans une zone protégée du système de fichiers, par exemple c:\Program Files\Anaconda3\Lib, Visual Studio doit exécuter pip install avec une élévation de privilèges pour lui permettre de créer des sous-dossiers de package.When installing packages into an environment that's located in a protected area of the file system, such as c:\Program Files\Anaconda3\Lib, Visual Studio must run pip install elevated to allow it to create package subfolders. Quand une élévation est nécessaire, 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. Quand vous sélectionnez Continuer sans privilège d’administrateur, une tentative d’installation du package a lieu, mais pip ne parvient pas à créer de dossiers, et une sortie telle que Erreur : impossible de créer « C:\Program Files\Anaconda3\Lib\site-packages\png.py » : Autorisation refusée s’affiche.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, puis 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.

Sous ce même onglet Options, vous pouvez également sélectionner Toujours exécuter pip comme administrateur afin de 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.

Restrictions de sécurité avec les versions antérieures de PythonSecurity restrictions with older versions of Python

Quand Python 2.6, 3.1 et 3.2 sont utilisés, Visual Studio affiche un avertissement signalant qu’en raison des restrictions de sécurité, l’installation à partir d’Internet est susceptible de ne pas fonctionner sur cette version de Python :When using Python 2.6, 3.1 and 3.2, Visual Studio shows the warning, Due to new security restrictions, installing from the internet may not work on this version of Python:

Message concernant les restrictions d’installation de pip avec l’ancienne version de Python

La raison de cet avertissement est que dans les versions plus anciennes de Python, pip install ne contient pas la prise en charge de la sécurité TLS (Transport Layer Security) 1.2, qui est nécessaire pour télécharger des packages à partir de la source de packages, pypi.org. Les builds Python personnalisées peuvent prendre en charge TLS 1.2, auquel cas pip install peut fonctionner.The reason for the warning is that with these older versions of Python, pip install doesn't contain support for the Transport Security Layer (TLS) 1.2, which is required for downloading packages from the package source, pypi.org. Custom Python builds may support TLS 1.2 in which case pip install might work.

Il est possible de télécharger le get-pip.py approprié pour un package à partir de bootstrap.pypa.io, de télécharger manuellement un package à partir de pypi.org, puis d’installer le package à partir de cette copie locale.It may be possible to download the appropriate get-pip.py for a package from bootstrap.pypa.io, manually download a package from pypi.org, and then install the package from that local copy.

La recommandation, toutefois, est d’effectuer simplement une mise à niveau vers Python 2.7 ou 3.3 +, auquel cas l’alerte n’apparaît pas.The recommendation, however, is to simply upgrade to Python 2.7 or 3.3+, in which case the warning does not appear.

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 complétions qui ne dépendent pas de la base de données par défaut.Visual Studio 2017 version 15.6 and later uses a faster method to provide completions that do not depend on the database by default. Pour cette raison, l’onglet est étiqueté IntelliSense [base de données désactivée].For this reason the tab is labeled IntelliSense [database disabled]. Vous pouvez activer la base de données en désactivant l’option Outils > Options > Python > Expérimental > Utiliser le nouveau style IntelliSense pour les environnements.You can enable the database by clearing the option Tools > Options > Python > Experimental > Use new style IntelliSense for environments.

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