Installieren von Python-Unterstützung für Visual Studio unter WindowsHow to install Python support in Visual Studio on Windows

Um die Python-Unterstützung für Visual Studio (auch als Python Tools für Visual Studio bzw. PTVS bezeichnet) zu installieren, befolgen Sie die Anweisungen in dem Abschnitt, der Ihrer Version von Visual Studio entspricht:To install Python support for Visual Studio (also known as Python Tools for Visual Studio or PTVS), follow the instructions in the section that matches your version of Visual Studio:

Wenn die Python-Unterstützung nach Ausführung der Installationsschritte schnell getestet werden soll, öffnen Sie das Fenster Interaktives Python, indem Sie die Tasten ALT+I drücken und 2+2 eingeben.To quickly test Python support after following the installation steps, open the Python Interactive window by pressing Alt+I and entering 2+2. Wenn Sie die Ausgabe von 4 nicht sehen, überprüfen Sie Ihre Schritte.If you don't see the output of 4, recheck your steps.

Tip

Die Python-Arbeitsauslastung enthält die hilfreiche Cookiecutter-Erweiterung, die eine grafische Benutzeroberfläche bietet, auf der Sie Vorlagen ermitteln, Vorlageoptionen eingeben und Projekte und Dateien erstellen können.The Python workload includes the helpful Cookiecutter extension that provides a graphical user interface to discover templates, input template options, and create projects and files. Weitere Einzelheiten finden Sie unter Verwenden von Cookiecutter.For details, see Use Cookiecutter.

Note

Python wird zurzeit nicht von Visual Studio für Mac unterstützt, steht jedoch auf Mac und Linux über Visual Studio-Code zur Verfügung.Python support is not presently available in Visual Studio for Mac, but is available on Mac and Linux through Visual Studio Code. Weitere Informationen finden Sie unter Questions and answers (Fragen und Antworten).See questions and answers.

Visual Studio 2017Visual Studio 2017

  1. Laden Sie den aktuellen Visual Studio 2017-Installer herunter, und führen Sie diesen aus.Download and run the latest Visual Studio 2017 installer. Wenn Sie Visual Studio bereits installiert haben, führen Sie den Visual Studio-Installer aus, wählen die Option Ändern aus (siehe Ändern von Visual Studio), und fahren Sie mit Schritt 2 fort.If you have Visual Studio installed already, run the Visual Studio Installer, select the Modify option (see Modify Visual Studio) and go to step 2.

    Tip

    Die Community Edition eignet sich für einzelne Entwickler, Schulungsumgebungen, akademische Forschung und Open Source-Entwicklung.The Community edition is for individual developers, classroom learning, academic research, and open source development. Installieren Sie für andere Verwendungen Visual Studio 2017 Professional oder Visual Studio 2017 Enterprise.For other uses, install Visual Studio 2017 Professional or Visual Studio 2017 Enterprise.

  2. Der Installer bietet Ihnen eine Liste von Workloads, bei denen es sich um Gruppen von verwandten Optionen für bestimmte Entwicklungsbereiche handelt.The installer presents you with a list of workloads, which are groups of related options for specific development areas. Wählen Sie für Python die Workload Python-Entwicklung aus.For Python, select the Python development workload.

    Arbeitsauslastung zur Python-Entwicklung im Visual Studio-Installationsprogramm

    Optional: Wenn Sie mit Data Science arbeiten, verwenden Sie ggf. die Workload Data Science und analytische Anwendungen.Optional: if you're working with data science, also consider the Data science and analytical applications workload. Diese Workload enthält Support für Python und R- und F#-Sprachen.This workload includes support for the Python, R, and F# languages. Weitere Informationen finden Sie unter Data science and analytical applications workload (Workload für Data Science und analytische Anwendungen).For more information, see Data science and analytical applications workload.

    Optional: Wenn Sie mit Data Science arbeiten, verwenden Sie ggf. die Workload Data Science und analytische Anwendungen.Optional: if you're working with data science, also consider the Data science and analytical applications workload. Diese Workload enthält Support für Python und F#-Sprachen.This workload includes support for the Python and F# languages. Weitere Informationen finden Sie unter Data science and analytical applications workload (Workload für Data Science und analytische Anwendungen).For more information, see Data science and analytical applications workload.

    Note

    Die Python- und Data Science-Workloads sind nur für Visual Studio 2017, Version 15.2 und höher verfügbar.The Python and Data Science workloads are available only with Visual Studio 2017 version 15.2 and later.

  3. Wählen Sie bei Bedarf zusätzliche Optionen auf der rechten Seite des Installers aus.On the right side of the installer, chose additional options if desired. Überspringen Sie diesen Schritt, um die Standardoptionen zu akzeptieren.Skip this step to accept the default options.

    Optionen zur Python-Entwicklung im Visual Studio-Installationsprogramm

    OptionOption BeschreibungDescription
    Python-VerteilungenPython distributions Wählen Sie eine beliebige Kombination aus den 32-Bit- und 64-Bit-Varianten der Python 2-, Python 3-, Anaconda2- und Anaconda3-Verteilungen aus, mit denen Sie arbeiten möchten.Choose any combination of the 32-bit and 64-bit variants of the Python 2, Python 3, Anaconda2, and Anaconda3 distributions that you plan to work with. Jede enthält den Interpreter, die Runtime und die Bibliotheken der Verteilung.Each includes the distribution's interpreter, runtime, and libraries. Bei Anaconda handelt es sich um eine offene Data Science-Plattform, die eine große Auswahl an vorinstallierten Paketen enthält.Anaconda, specifically, is an open data science platform that includes a wide range of pre-installed packages. (Sie können jederzeit zum Visual Studio-Installer zurückkehren, um Verteilungen hinzuzufügen oder zu entfernen.) Hinweis: Wenn Sie eine Distribution außerhalb des Visual Studio-Installers installiert haben, muss die entsprechende Option hier nicht aktiviert werden.(You can return to the Visual Studio installer at any time to add or remove distributions.) Note: If you've installed a distribution outside of the Visual Studio installer, there's no need to check the equivalent option here. Visual Studio erkennt vorhandene Python-Installationen automatisch.Visual Studio automatically detects existing Python installations. Weitere Informationen finden Sie im Fenster „Python-Umgebungen“.See The Python Environments window. Wenn eine neuere Version von Python als im Installationsprogramm angezeigt verfügbar ist, können Sie diese Version separat installieren, und Visual Studio erkennt sie.Also, if a newer version of Python is available than what's shown in the installer, you can install that version separately and Visual Studio will detect it.
    Unterstützung von Cookiecutter-VorlagenCookiecutter template support Installiert die grafische Benutzeroberfläche von Cookiecutter, um Vorlagen zu ermitteln, Vorlagenoptionen einzugeben und Projekte und Dateien zu erstellen.Installs the Cookiecutter graphical UI to discover templates, input template options, and create projects and files. Weitere Informationen finden Sie unter Verwenden der Cookiecutter-Erweiterung.See Use the Cookiecutter extension.
    Webunterstützung für PythonPython web support Installiert Tools für die Webentwicklung einschließlich der Bearbeitungsunterstützung für HTML, CSS und JavaScript sowie Vorlagen für Projekte, die Bottle-, Flask- und Django-Frameworks verwenden.Installs tools for web development including HTML, CSS, and JavaScript editing support, along with templates for projects using the Bottle, Flask, and Django frameworks. Weitere Informationen finden Sie unter Python-Webprojektvorlagen.See Python web project templates.
    IoT-Unterstützung für PythonPython IoT support Unterstützt die Windows IoT Core-Entwicklung mithilfe von Python.Supports Windows IoT Core development using Python.
    Native Python-EntwicklungstoolsPython native development tools Installiert den C++-Compiler und andere erforderliche Komponenten, um native Erweiterungen für Python zu entwickeln.Installs the C++ compiler and other necessary components to develop native extensions for Python. Weitere Informationen finden Sie unter Erstellen einer C++-Erweiterung für Python.See Create a C++ extension for Python. Installieren Sie außerdem die Workload Desktopentwicklung mit C++, um über volle Unterstützung für C++ zu verfügen.Also install the Desktop development with C++ workload for full C++ support.
    Kerntools für Azure Cloud ServicesAzure Cloud Services core tools Bietet zusätzliche Unterstützung für Azure Cloud Services-Entwickler in Python.Provides additional support for developer Azure Cloud Services in Python. Weitere Informationen finden Sie unter Projekte für Azure Cloud Services.See Azure cloud service projects.
  4. Nach der Installation bietet der Installer Optionen für das Ändern, Starten, Reparieren oder Deinstallieren von Visual Studio.After installation, the installer provides options to modify, launch, repair, or uninstall Visual Studio. Die Schaltfläche Ändern ändert sich zu Aktualisieren, wenn Updates für die installierten Komponenten von Visual Studio verfügbar sind.The Modify button changes to Update when updates to Visual Studio are available for any installed components. (Die Option Ändern ist anschließend im Dropdownmenü verfügbar.) Sie können Visual Studio und den Installer ebenfalls über das Windows-Menü Start starten, indem Sie nach „Visual Studio“ suchen.(The Modify option is then available on the drop-down menu.) You can also launch Visual Studio and the installer from the Windows Start menu by searching on "Visual Studio".

    Starten, Ändern oder Deinstallieren von Visual Studio über den Installer

ProblembehandlungTroubleshooting

Wenn Probleme bei der Installation oder Ausführung von Python in Visual Studio auftreten, versuchen Sie Folgendes:If you encounter problems installing or running Python in Visual Studio, try the following:

  • Überprüfen Sie, ob der gleiche Fehler über die Python-CLI auftritt, d.h. bei Ausführen von python.exe über eine Eingabeaufforderung.Determine whether the same error occurs using the Python CLI, that is, running python.exe from a command prompt.
  • Verwenden Sie die Reparaturoption im Visual Studio-Installer.Use the Repair option in the Visual Studio installer.
  • Reparieren oder installieren Sie Python neu über Einstellungen > Apps & Features (unter Windows).Repair or reinstall Python through Settings > Apps & features in Windows.

Beispielfehler: Failed to start interactive process: System.ComponentModel.Win32Exception (0x80004005): Unknown error (0xc0000135) at Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext(). (Fehler beim Starten des interaktiven Prozesses: System.ComponentModel.Win32Exception (0x80004005): Unbekannter Fehler (0xc0000135) bei Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext().)Example error: Failed to start interactive process: System.ComponentModel.Win32Exception (0x80004005): Unknown error (0xc0000135) at Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext().

Visual Studio 2015Visual Studio 2015

  1. Führen Sie das Visual Studio-Installationsprogramm über Systemsteuerung > Programme und Funktionen aus, wählen Sie Microsoft Visual Studio 2015 aus, und dann Ändern.Run the Visual Studio installer through Control Panel > Programs and Features, selecting Microsoft Visual Studio 2015 and then Change.

  2. Wählen Sie im Installationsprogramm Ändern.In the installer, select Modify.

  3. Wählen Sie Programmiersprachen > Python-Tools für Visual Studio und dann Weiter aus:Select Programming Languages > Python Tools for Visual Studio and then Next:

    PTVS-Option im Visual Studio 2015-Installationsprogramm

  4. Nach Abschluss der Installation von Visual Studio installieren Sie einen Python-Interpreter Ihrer Wahl.Once Visual Studio setup is complete, install a Python interpreter of your choice. Visual Studio 2015 unterstützt nur Python 3.5 und früher. Spätere Versionen erzeugen Fehlermeldungen wie Nicht unterstützte Python-Version 3.6.Visual Studio 2015 supports only Python 3.5 and earlier; later versions generate a message like Unsupported Python version 3.6). Wenn Sie bereits einen Interpreter installiert haben und Visual Studio diesen nicht automatisch erkennt, finden Sie weitere Informationen unter Manuelles Identifizieren einer vorhandenen Umgebung.If you already have an interpreter installed and Visual Studio doesn't detect it automatically, see Manually identify an existing environment.

Visual Studio 2013 und früherVisual Studio 2013 and earlier

  1. Installieren Sie die entsprechende Version der Python-Tools für Visual Studio für Ihre Version von Visual Studio:Install the appropriate version of Python Tools for Visual Studio for your version of Visual Studio:

  2. Installieren Sie einen Python-Interpreter Ihrer Wahl.Install a Python interpreter of your choice. Wenn Sie bereits einen Interpreter installiert haben und Visual Studio diesen nicht automatisch erkennt, finden Sie weitere Informationen unter Manuelles Identifizieren einer vorhandenen Umgebung.If you already have an interpreter installed and Visual Studio doesn't detect it automatically, see Manually identify an existing environment.

InstallationsspeicherorteInstall locations

Standardmäßig wird die Python-Unterstützung für alle Benutzer auf einem Computer installiert.By default, Python support is installed for all users on a computer.

Bei Visual Studio 2017 wird die Python-Workload unter %ProgramFiles(x86)%\Microsoft Visual Studio\2017\<VS_edition>Common7\IDE\Extensions\Microsoft\Python installiert, wobei <VS_edition> für Community, Professional oder Enterprise steht.For Visual Studio 2017, the Python workload is installed in %ProgramFiles(x86)%\Microsoft Visual Studio\2017\<VS_edition>Common7\IDE\Extensions\Microsoft\Python where <VS_edition> is Community, Professional, or Enterprise.

Für Visual Studio 2015 und früher gelten folgende Installationspfade:For Visual Studio 2015 and earlier, installation paths are as follows:

  • 32-Bit:32-bit:
    • Pfad: %Program Files(x86)%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>Path: %Program Files(x86)%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>
    • Registrierungsspeicherort des Pfads: HKEY_LOCAL_MACHINE\Software\Microsoft\PythonTools\<VS_ver>\InstallDirRegistry location of path: HKEY_LOCAL_MACHINE\Software\Microsoft\PythonTools\<VS_ver>\InstallDir
  • 64-Bit:64-bit:
    • Pfad: %Program Files%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>Path: %Program Files%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>
    • Registrierungsspeicherort des Pfads: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\PythonTools\<VS_ver>\InstallDirRegistry location of path: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\PythonTools\<VS_ver>\InstallDir

Dabei gilt:where:

  • <VS_ver> ist:<VS_ver> is:
    • 14.0 für Visual Studio 201514.0 for Visual Studio 2015
    • 12.0 für Visual Studio 201312.0 for Visual Studio 2013
    • 11.0 für Visual Studio 201211.0 for Visual Studio 2012
    • 10.0 für Visual Studio 201010.0 for Visual Studio 2010
  • <PTVS_ver> ist eine Versionsnummer, z.B. 2.2, 2.1, 2.0, 1.5, 1.1 oder 1.0.<PTVS_ver> is a version number, such as 2.2, 2.1, 2.0, 1.5, 1.1, or 1.0.

Benutzerspezifische Installationen (1.5 und früher)User-specific installations (1.5 and earlier)

Bei Python Tools für Visual Studio 1.5 und früheren Versionen war die Installation nur für den aktuellen Benutzer zulässig. In diesem Fall lautet der Installationspfad %LocalAppData%\Microsoft\VisualStudio\<VS_ver>\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>, wobei für <VS_ver> und <PTVS_ver> die obige Beschreibung gilt.Python Tools for Visual Studio 1.5 and earlier allowed installation for the current user only, in which case the installation path is %LocalAppData%\Microsoft\VisualStudio\<VS_ver>\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver> where <VS_ver> and <PTVS_ver> are the same as described above.