Sélectionner un environnement et un interpréteur Python à utiliser dans un projetSelecting a Python interpreter and environment for use in a project

Tout le code d’un projet Python s’exécute dans le contexte d’un environnement précis.All code in a Python project runs within the context of a specific environment. Visual Studio utilise également cet environnement pour le débogage, l’importation et les saisies semi-automatiques de membres, la vérification syntaxique et les autres tâches qui nécessitent un environnement.Visual Studio also uses that environment for debugging, import and member completions, syntax checking, and any other tasks that require an environment.

Tous les nouveaux projets Python dans Visual Studio sont initialement configurés de façon à utiliser l’environnement global par défaut, qui s’affiche sous le nœud Environnements Python dans l’Explorateur de solutions :All new Python projects in Visual Studio are initially configured to use the default global environment, which appears under the Python Environments node in Solution Explorer:

Environnement Python global par défaut indiqué dans l’Explorateur de solutions

Pour modifier l’environnement d’un projet, cliquez sur le nœud Environnements Python et sélectionnez Ajouter/Supprimer des environnements Python... . Dans la liste affichée, qui inclut les environnements de type global, virtuel et conda, sélectionnez tous ceux que vous souhaitez voir apparaître sous le nœud Environnements Python :To change the environment for a project, right-click the Python Environments node and select Add/Remove Python Environments.... From the displayed list, which includes global, virtual, and conda environments, select all the ones you want to appear under the Python Environments node:

Boîte de dialogue Ajouter/supprimer des environnements Python

Cliquez sur OK : tous les environnements sélectionnés s’affichent sous le nœud Environnements Python.Once you select OK, all the selected environments appear Python Environments node. L’environnement actuellement activé apparaît en gras :The currently activated environment appears in bold:

Plusieurs environnements Python qui s’affichent dans l’Explorateur de solutions

Pour activer rapidement un autre environnement, cliquez dessus avec le bouton droit et sélectionnez Activer l’environnement.To quickly activate a different environment, right-click that environment name and select Activate environment. Votre choix sera enregistré avec le projet, et cet environnement sera activé chaque fois que vous ouvrirez le projet.Your choice is saved with the project and that environment is activated whenever you open the project in the future. Si vous désactivez toutes les options de la boîte de dialogue Ajouter/supprimer des environnements Python, Visual Studio active l’environnement global par défaut.If you clear all the options in the Add/Remove Python Environments dialog, Visual Studio activates the global default environment.

Le menu contextuel sur le nœud Environnements Python propose également des commandes supplémentaires :The context menu on the Python Environments node also provides additional commands:

CommandeCommand DescriptionDescription
Ajouter un environnement virtuel...Add Virtual Environment... Commence le processus de création d’un environnement virtuel dans le projet.Begins the process of creating a new virtual environment in the project. Voir Créer un environnement virtuel.See Create a virtual environment.
Ajouter un environnement virtuel existant...Add Existing Virtual Environment... Vous invite à sélectionner un dossier contenant un environnement virtuel et l’ajoute à la liste sous Environnements Python, mais ne l’active pas.Prompts you to select a folder containing a virtual environment and adds it to the list under Python Environments, but does not activate it. Voir Ajouter un environnement virtuel existant.See ActivateAdd an existing virtual environment.
Créer un environnements conda...Create Conda environment... Bascule vers la fenêtre Environnements Python, dans laquelle vous pouvez entrer un nom pour l’environnement et spécifier son interpréteur de base.Switches to the Python Environments window in which you enter a name for the environment and specify its base interpreter.

Utiliser des environnements virtuelsUsing virtual environments

Un environnement virtuel est une combinaison unique entre un interpréteur Python donné et un ensemble précis de bibliothèques, qui diffère des autres environnements globaux et conda.A virtual environment is a unique combination of a specific Python interpreter and a specific set of libraries that is different from other global and conda environments. Un environnement virtuel est spécifique à un projet et conservé dans un dossier de projet.A virtual environment is specific to a project and is maintained in a project folder. Ce dossier contient les bibliothèques de l’environnement installées avec un fichier pyvenv.cfg qui spécifie le chemin d’accès à l’interpréteur de base de l’environnement ailleurs sur le système de fichiers.That folder contains the environment's installed libraries along with a pyvenv.cfg file that specifies the path to the environment's base interpreter elsewhere on the file system. (Autrement dit, un environnement virtuel ne contient pas de copie de l’interpréteur, mais uniquement un lien vers celui-ci.)(That is, a virtual environment doesn't contain a copy of the interpreter, only a link to it.)

Un des avantages de l’utilisation d’un environnement virtuel est qu’au fur et à mesure du développement du projet, l’environnement virtuel reflète toujours les dépendances exactes du projet.A benefit to using a virtual environment is that as you develop project over time, the virtual environment always reflects the project's exact dependencies. (En revanche, un environnement global partagé contient un certain nombre de bibliothèques, que vous les utilisiez ou pas.) Vous pouvez donc facilement créer un fichier requirements.txt à partir de l’environnement virtuel, qui est ensuite utilisé pour réinstaller ces dépendances sur un autre ordinateur de développement ou de production.(A shared global environment, on the other hand, contain any number of libraries whether you use them in your project or not.) You can then easily create a requirements.txt file from the virtual environment, which is then used to reinstall those dependencies on another development or production computer. Pour plus d’informations, consultez la page Gérer les packages requis avec requirements.txt.For more information, see Managing required packages with requirements.txt.

Lorsque vous ouvrez un projet contenant un fichier requirements.txt dans Visual Studio, Visual Studio vous propose automatiquement l’option qui permet de recréer l’environnement virtuel.When you open a project in Visual Studio that contains a requirements.txt file, Visual Studio automatically prompts gives you the option to recreate the virtual environment. Sur les ordinateurs où Visual Studio n’est pas installé, par exemple Azure App Service, vous pouvez utiliser pip install -r requirements.txt pour restaurer les packages (ce processus est décrit sur Gestion de Python sur Azure App Service).On computers where Visual Studio isn't installed, such as Azure App Service, you can use pip install -r requirements.txt to restore the packages (this process is described on Managing Python on Azure App Service).

Un environnement virtuel contient un chemin d’accès codé en dur à l’interpréteur de base, et comme vous pouvez recréer l’environnement à l’aide de requirements.txt, vous omettez généralement l’ensemble du dossier de l’environnement virtuel à partir du contrôle de code source.Because a virtual environment contains a hard-coded path to the base interpreter, and because you can recreate the environment using requirements.txt, you typically omit the entire virtual environment folder from source control.

Les sections suivantes expliquent comment activer un environnement virtuel existant dans un projet et comment créer un environnement virtuel.The following sections explain how to activate an existing virtual environment in a project and how to create a new virtual environment.

Dans Visual Studio, un environnement virtuel peut, comme n’importe quel autre environnement, être activé pour un projet via le nœud Environnements Python dans l’Explorateur de solutions.In Visual Studio, a virtual environment can be activated for a project like any other through the Python Environments node in Solution Explorer.

Une fois qu’un environnement virtuel est ajouté à votre projet, il apparaît dans la fenêtre Environnements Python.Once a virtual environment is added to your project, it appears in the Python Environments window. Vous pouvez ensuite l’activer, comme tout autre environnement, et vous pouvez gérer ses packages.You can then activate it like any other environment, and you can manage its packages.

Créer un environnement virtuelCreate a virtual environment

Vous pouvez créer un nouvel environnement virtuel directement sur Visual Studio de la façon suivante :You can create a new virtual environment directly from Visual Studio as follows:

  1. Cliquez avec le bouton droit sur Environnements Python dans l’Explorateur de solutions, puis sélectionnez Ajouter un environnement virtuel... pour afficher la boîte de dialogue suivante :Right-click Python Environments in Solution Explorer and select Add Virtual Environment..., which brings up the following dialog box:

    Création d’un environnement virtuel

  2. Dans le champ Emplacement de l’environnement virtuel, spécifiez un chemin d’accès pour l’environnement virtuel.In the Location of the virtual environment field, specify a path for the virtual environment. Si vous n’indiquez qu’un nom, l’environnement virtuel sera créé dans le projet actuel, dans un sous-dossier portant ce nom.If you specify a name only, the virtual environment is created within the current project in a subfolder with that name.

  3. Sélectionnez un environnement comme interpréteur de base et cliquez sur Créer.Select an environment as the base interpreter and select Create. Visual Studio affiche une barre de progression pendant qu’il configure l’environnement et télécharge les packages nécessaires.Visual Studio displays a progress bar while it configures the environment and downloads any necessary packages. À ce stade, l’environnement virtuel apparaît dans la fenêtre Environnements Python du projet auquel il appartient.At this point, the virtual environment appears in the Python Environments window for the containing project.

  4. L’environnement virtuel n’est pas activé par défaut.The virtual environment is not activated by default. Pour l’activer pour le projet, cliquez dessus avec le bouton droit et sélectionnez Activer l’environnement.To activate it for the project, right-click it and select Activate Environment.

Note

Si le chemin d’accès identifie un environnement virtuel existant, Visual Studio détecte automatiquement l’interpréteur de base (à l’aide du fichier orig-prefix.txt dans le répertoire lib de l’environnement) et remplace le bouton Créer par Ajouter.If the location path identifies an existing virtual environment, Visual Studio detects the base interpreter automatically (using the orig-prefix.txt file in the environment's lib directory) and changes the create button to Add.

Si un fichier requirements.txt existe lors de l’ajout d’un environnement virtuel, la boîte de dialogue Ajouter un environnement virtuel affiche une option permettant d’installer les packages automatiquement, et donc de recréer un environnement sur un autre ordinateur en toute simplicité :If a requirements.txt file exists when adding a virtual environment, the Add Virtual Environment dialog displays an option to install the packages automatically, making it easy to recreate an environment on another computer:

Créer un environnement virtuel avec requirements.txt

Dans les deux cas, le résultat est le même qu’avec la commande Ajouter un environnement virtuel existant... .Either way, the result is the same as if you'd used the Add Existing Virtual Environment... command.

Activer un environnement virtuel existantActivate an existing virtual environment

Si vous avez déjà créé un environnement virtuel ailleurs, vous pouvez l’activer pour un projet de la façon suivante :If you've already created a virtual environment elsewhere, you can activate it for a project as follows:

  1. Cliquez avec le bouton droit sur Environnements Python dans l’Explorateur de solutions, puis sélectionnez Ajouter un environnement virtuel existant....Right-click Python Environments in Solution Explorer and select Add Existing Virtual Environment....

  2. Dans la boîte de dialogue Parcourir qui s’affiche, accédez au dossier contenant l’environnement virtuel, sélectionnez-le et cliquez sur OK.In the Browse dialog that appears, Navigate to and select the folder that contains the virtual environment, and select OK. Si Visual Studio détecte un fichier requirements.txt dans cet environnement, il demande s’il faut installer ces packages.If Visual Studio detects a requirements.txt file in that environment, it asks whether to install those packages.

  3. Après quelques instants, l’environnement virtuel apparaît sous le nœud Environnements Python de l’Explorateur de solutions.After a few moments, the virtual environment appears under the Python Environments node in Solution Explorer. Il n’est pas activé par défaut : cliquez dessus avec le bouton droit et sélectionnez Activer l’environnement.The virtual environment is not activated by default, so right-click it and select Activate Environment.

Retirer un environnement virtuelRemove a virtual environment

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur l’environnement virtuel et sélectionnez Retirer.In Solution Explorer, right-click the virtual environment and select Remove.

  2. Visual Studio demande s’il faut retirer ou supprimer l’environnement virtuel.Visual Studio asks whether to remove or delete the virtual environment. L’action Retirer le rend inaccessible au projet, mais elle le laisse sur le système de fichiers.Selecting Remove makes it unavailable to the project but leaves it on the file system. L’action Supprimer retire l’environnement du projet et le supprime du système de fichiers.Selecting Delete both removes the environment from the project and deletes it from the file system. L’interpréteur de base n’est pas affecté.The base interpreter is unaffected.

Afficher les packages installésView installed packages

Dans l’Explorateur de solutions, développez le nœud d’un environnement donné pour afficher rapidement les packages qui y sont installés (que vous pouvez donc importer et utiliser dans votre code lorsque l’environnement est actif) :In Solution Explorer, expand any specific environment's node to quickly view the packages that are installed in that environment (meaning that you can import and use those packages in your code when the environment is active):

Packages Python pour un environnement dans l’Explorateur de solutions

Pour installer de nouveaux packages, cliquez avec le bouton droit sur l’environnement, puis sélectionnez Installer un package Python... pour basculer vers l’onglet Packages sur la fenêtre Environnements Python.To install new packages, right-click the environment and select Install Python Package... to switch to the Packages tab in the Python Environments window. Entrez un critère recherche (en général, le nom de package) : Visual Studio affichera les packages correspondants.Enter a search term (usually the package name) and Visual Studio displays matching packages.

Dans Visual Studio, les packages (et les dépendances) sont téléchargés à partir de Python Package Index (PyPI), où vous pouvez également rechercher les packages disponibles.Within Visual Studio, packages (and dependencies) are downloaded from the Python Package Index (PyPI), where you can also search for available packages. La barre d’état et la fenêtre Sortie de Visual Studio affichent des informations sur l’installation.Visual Studio's status bar and output window show information about the install. Pour désinstaller un package, cliquez avec le bouton sur celui-ci et sélectionnez Supprimer.To uninstall a package, right-click it select Remove.

Sachez que les entrées affichées ne sont pas toujours exactes, et que l’installation et la désinstallation ne sont pas forcément fiables ou disponibles.Be aware that the displayed entries may not always be accurate, and installation and uninstallation may not be reliable or available. Visual Studio utilise le gestionnaire de packages pip s’il est disponible, et le télécharge et l’installe si besoin.Visual Studio uses the pip package manager if available, and downloads and installs it when required. Visual Studio peut également utiliser le gestionnaire de packages easy_install.Visual Studio can also use the easy_install package manager. Les packages installés en ligne de commande avec pip ou easy_install s’affichent également.Packages installed using pip or easy_install from the command line are also displayed.

Sachez également que Visual Studio ne prend pas en charge pour le moment l’utilisation de conda pour installer des packages dans un environnement conda.Also note that Visual Studio does not presently support using conda to install packages into a conda environment. Utilisez plutôt conda en ligne de commande.Use conda from the command line instead.

Conseil

Il est courant que pip ne parvienne pas à installer un package quand celui-ci inclut le code source pour les composants natifs dans les fichiers *.pyd.A common situation where pip fails to install a package is when the package includes source code for native components in *.pyd files. Si la version requise de Visual Studio n’est pas installée, pip n’est pas en mesure de compiler ces composants.Without the required version of Visual Studio installed, pip cannot compile these components. Le message d’erreur affiché dans ce cas est error: Unable to find vcvarsall.bat.The error message displayed in this situation is error: Unable to find vcvarsall.bat. easy_install est souvent capable de télécharger des binaires précompilés, et vous pouvez télécharger un compilateur approprié pour les versions antérieures de Python à partir de http://aka.ms/VCPython27.easy_install is often able to download pre-compiled binaries, and you can download a suitable compiler for older versions of Python from http://aka.ms/VCPython27. Pour plus d’informations, consultez le billet How to deal with the pain of "unable to find vcvarsallbat" (Comment gérer l’erreur « unable to find vcvarsallbat ») sur le blog de l’équipe Python Tools.For more details, see How to deal with the pain of "unable to find vcvarsallbat" on the Python tools team blog.

Voir aussiSee also