Installer les interpréteurs Python

Il existe plusieurs options d’installation d’interpréteurs Python pour travailler avec Visual Studio. Vous pouvez installer un interpréteur lors de l’installation de la charge de travail Python, ou vous pouvez installer un interpréteur après qu’une charge de travail soit présente. Les interpréteurs peuvent également être installés manuellement en dehors de l’installateur de Visual Studio.

Lorsque vous installez la charge de travail de développement Python dans Visual Studio 2017 et ultérieurement, Python 3 (64 bits) est également installé par défaut. En option, vous pouvez choisir d’installer la version 32 bits ou 64 bits de Python 2 ou Python 3, ainsi que Miniconda (Visual Studio 2019) ou Anaconda 2/Anaconda 3 (Visual Studio 2017). Les étapes pour ce type d’installation sont décrites dans Installer le support Python dans Visual Studio.

Une approche alternative consiste à installer des interpréteurs Python standards en utilisant la fonctionnalité Ajouter un environnement dans Visual Studio. Cette option est disponible dans la fenêtre Environnements Python et la barre d’outils Python.

Les interpréteurs Python peuvent également être installés manuellement en dehors de l’installateur de Visual Studio. Supposons que vous installez Anaconda 3 avant d’installer Visual Studio. Vous n’avez pas besoin de réinstaller Anaconda via l’installateur de Visual Studio. Vous pouvez également installer une version plus récente d’un interpréteur si elle n’est pas encore répertoriée dans l’installateur de Visual Studio.

Prérequis

  • Visual Studio prend en charge Python version 3.7. Bien qu’il soit possible d’utiliser une version antérieure de Visual Studio pour éditer du code écrit dans des versions antérieures de Python, ces versions de Python ne sont pas officiellement prises en charge. Les fonctionnalités de Visual Studio telles que IntelliSense et le débogage peuvent ne pas fonctionner avec des versions antérieures de Python.

  • Pour Visual Studio 2015 et antérieur, utilisez Python 3.5 ou antérieur. Vous devez installer manuellement l’un des interpréteurs Python.

Distributions Anaconda

Bien que Visual Studio propose d’installer la distribution Anaconda, votre utilisation de la distribution et d’autres packages du dépôt Anaconda est liée par les Conditions d’utilisation d’Anaconda. Ces conditions peuvent exiger que certaines organisations paient Anaconda pour une licence commerciale, ou bien configurent les outils pour accéder à un dépôt alternatif. Pour plus d’informations, veuillez consulter la Documentation des canaux Conda.

Revoir les interpréteurs Python

Le tableau suivant répertorie les interpréteurs Python qui peuvent être utilisés avec Visual Studio.

Interpréteur Description Notes
CPython Interpréteur « natif » et le plus couramment utilisé, disponible en versions 32 bits et 64 bits (version 32 bits recommandée). Il inclut les dernières fonctionnalités du langage, une compatibilité des packages Python maximale, la prise en charge complète du débogage et l’interopérabilité avec IPython. Consultez les considérations dans Devrais-je utiliser Python 2 ou Python 3 ? pour aider à déterminer quelle version de Python installer. Visual Studio 2015 et antérieur ne prennent pas en charge Python 3.6 ou ultérieur, et peuvent retourner des erreurs comme Version de Python 3.6 non prise en charge. Pour Visual Studio 2015 et antérieur, utilisez Python 3.5 ou antérieur.
IronPython Une implémentation .NET de Python, disponible en versions 32 bits et 64 bits. Fournit une interopérabilité C#/F#/Visual Basic, un accès aux API .NET, un débogage Python standard (mais pas un débogage en mode mixte C++), et un débogage mixte IronPython/C#. IronPython ne prend pas en charge les environnements virtuels.
Anaconda Une plate-forme de science des données ouverte alimentée par Python. Inclut la dernière version de CPython et la plupart des packages difficiles à installer. Si vous hésitez sur le choix d’un interpréteur, nous recommandons d’utiliser Anaconda.
PyPy Une implémentation JIT de traçage haute performance de Python. Bon pour les programmes de longue durée et les situations où vous identifiez des problèmes de performance mais ne trouvez pas d’autres résolutions. Fonctionne avec Visual Studio, mais avec une prise en charge limitée des fonctionnalités de débogage avancées.
Jython Une implémentation de Python sur la Machine virtuelle Java (JVM). Comme IronPython, le code exécuté dans Jython peut interagir avec les classes et bibliothèques Java. Cependant, de nombreuses bibliothèques destinées à CPython peuvent ne pas être accessibles. Fonctionne avec Visual Studio, mais avec une prise en charge limitée des fonctionnalités de débogage avancées.

Détecter votre environnement

Visual Studio affiche tous les environnements connus dans la fenêtre Environnements Python. Il détecte automatiquement les mises à jour des interpréteurs existants.

Si Visual Studio ne détecte pas un environnement installé, veuillez consulter la rubrique Identifier manuellement un environnement existant.

Si vous souhaitez fournir de nouvelles formes de détection pour les environnements Python, consultez PTVS Environment Detection (github.com).

Entrées du Registre

Visual Studio (toutes versions) détecte automatiquement chacun des interpréteurs Python installés et l’environnement associé en consultant le Registre (conformément à PEP 514 – Inscription de Python dans le Registre Windows). Les installations Python se trouvent généralement sous la clé HKEY_LOCAL_MACHINE\SOFTWARE\Python (32 bits) et HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python (64 bits) dans les nœuds pour la distribution, tels que PythonCore (CPython) et ContinuumAnalytics (Anaconda).

Déplacer un interpréteur

Si vous déplacez un interpréteur existant vers un nouvel emplacement à l’aide du système de fichiers, Visual Studio ne détecte pas automatiquement le changement.

  • Si vous avez initialement spécifié l’emplacement de l’interpréteur via la fenêtre Environnements Python, vous pouvez éditer son environnement en utilisant l’onglet Configurer dans cette fenêtre pour identifier le nouvel emplacement. Pour plus d’informations, veuillez consulter Identifier manuellement un environnement existant.

  • Si vous avez installé l’interpréteur à l’aide d’un programme d’installation, utilisez la procédure suivante pour réinstaller l’interpréteur dans le nouvel emplacement :

    1. Restaurez l’interpréteur Python à son emplacement d’origine.
    2. Désinstallez l’interpréteur à l’aide de son programme d’installation, ce qui efface les entrées de registre.
    3. Réinstallez l’interpréteur au nouvel emplacement.
    4. Redémarrez Visual Studio, qui devrait détecter automatiquement le nouvel emplacement à la place de l’ancien.

Ce processus garantit que les entrées de registre qui identifient l’emplacement de l’interpréteur, que Visual Studio utilise, sont correctement mises à jour. Utiliser un programme d’installation gère également tout autre effet secondaire qui pourrait exister.