Installieren und Konfigurieren von Python zur Verwendung in MATLAB
R2026bDamit Sie Python® aus MATLAB® aufrufen können, muss auf Ihrem System eine unterstützte Version der Referenzimplementierung (CPython) installiert sein. Zudem müssen Sie Ihre Python-Umgebung zur Arbeit mit MATLAB konfigurieren.
Überprüfen einer bestehenden Python-Installation
Wenn Python bei Ihnen bereits installiert ist, überprüfen Sie unter Versions of Python Compatible with MATLAB Products by Release, ob MATLAB Ihre Python-Version unterstützt.
Ihre bestehende Python-Installation muss zudem die folgenden plattformspezifischen Anforderungen erfüllen:
Windows® – Die 64-Bit-Version von Python ist installiert. 32-Bit-Versionen werden nicht unterstützt.
Windows – Python wurde nicht über den Microsoft® Store installiert.
Linux® und Mac – Wenn Sie Python aus dem Quellcode erstellt haben, muss der Build mit der Option
--enable-sharedkonfiguriert sein. Weitere Informationen finden Sie unter Configure Python in der Python-Dokumentation.Mac – Ihre MATLAB- und Python-Installationen weisen dieselbe Architektur auf (Apple-Hardware oder Intel®-Prozessor). Weitere Informationen finden Sie unter Verwendung von Python von MATLAB aus auf einem Mac mit Apple Silicon.
Installieren von Python
Wenn auf Ihrem System keine unterstützte Version von Python installiert ist, können Sie diese entweder über den Fensterbereich „Add-Ons“ in MATLAB oder über python.org installieren.
Installieren von Python über den MATLAB-Fensterbereich „Add-Ons“
Seit R2026b
Um Python über den Fensterbereich „Add-Ons“ in MATLAB zu installieren, befolgen Sie diese Schritte:
Öffnen Sie den Fensterbereich „Add-Ons“ über das Symbol „Add-Ons“ auf der linken Seitenleiste auf dem Desktop. Wird das Symbol „Add-Ons“ nicht angezeigt, klicken Sie auf die Schaltfläche „Open more panels“ (Mehr Fensterbereiche öffnen)
und wählen Sie den Fensterbereich „Add-Ons“ aus.Suchen Sie nach dem Text MATLAB Support for Python.
Wählen Sie das Add-On für die zu installierende Python-Version aus.
Klicken Sie auf die Schaltfläche Install.
Sie können nun diese installierte Version von Python mithilfe von pyenv oder dem Fensterbereich „External Languages“ (Externe Sprachen) als Python-Umgebung auswählen. Weitere Informationen finden Sie unter Manage Python Environments Using External Languages Panel.
Python von python.org installieren
Um Python von python.org zu installieren, befolgen Sie diese Schritte:
Rufen Sie
https://www.python.org/downloads/auf und scrollen Sie zum Abschnitt Looking for a specific release.Suchen Sie die gewünschte Version und klicken Sie auf Download. Informationen zu unterstützten Versionen finden Sie unter Mit MATLAB-Produkten nach Version kompatible Python Versionen.
Klicken Sie auf das zu installierende Format und folgen Sie den Online-Anweisungen.
Wählen Sie auf Windows das 64-Bit-Format aus.
Konfigurieren Sie beim Erstellen der Python-Ausführungsdatei aus Quellcode auf Linux und Mac den Build mit der Option
--enable-shared. Weitere Informationen finden Sie unter Configure Python in der Python-Dokumentation.
Konfigurieren von MATLAB für die Verwendung der Python-Umgebung
Sie können MATLAB darauf konfigurieren, entweder eine Basisumgebung (eine systemweite Python-Installation) oder eine virtuelle Umgebung (einen isolierten, projektspezifischen Ordner mit Python-Paketen) zu verwenden. Wenn Sie keine virtuelle Umgebung haben, können Sie diese über den Fensterbereich „External Languages“ (Externe Sprachen) aus der Basisumgebung erstellen (siehe Manage Python Environments Using External Languages Panel). Wenn Sie die virtuelle Umgebung programmatisch erstellen möchten, finden Sie weitere Informationen im MATLAB-Artikel Python virtual environments with MATLAB und im Python-Tutorial Virtual Environments and Packages.
Um Ihre Python-Umgebung einzurichten, verwenden Sie den Fensterbereich „External Languages“ (Externe Sprachen), die Funktion pyenv oder die Umgebungsvariable PYTHONHOME.
Auswählen der Python-Umgebung mithilfe des Fensterbereichs „External Languages“ (Externe Sprachen)
Seit R2026a
Die einfachste Methode zur Konfiguration von MATLAB zur Verwendung von Python besteht darin, mithilfe des Fensterbereichs „External Languages“ (Externe Sprachen) eine Basisumgebung oder virtuelle Umgebung auszuwählen.
Um die Python-Ansicht im Fensterbereich „External Languages“ (Externe Sprachen) zu öffnen, klicken Sie auf die Schaltfläche „Open more panels“ (weitere Fensterbereiche öffnen)
auf einer beliebigen Seitenleiste und daraufhin auf External Languages. Wählen Sie daraufhin die Option Pythonaus der Sprachenliste in der oberen linke Ecke des Fensterbereichs aus.Wählen Sie Ihre bevorzugte virtuelle oder Basis-Python-Umgebung aus, indem Sie im Abschnitt All Python Environments auf eine Umgebung rechtsklicken und Set as Selected Environment auswählen.
Die ausgewählte Umgebung erscheint im Abschnitt Selected Python Environment des Fensterbereichs „External Languages“ (Externe Sprachen).
Weitere Informationen finden Sie unter Manage Python Environments Using External Languages Panel.
Einstellen der Python-Version auf Windows
Wenn Sie Python mit dem Standard-Installationsprogramm installiert haben, ist Python in der Windows-Registry registriert. Verwenden Sie den Namen-Wert-Paar Version von pyenv, um die zu verwendende Python-Version festzulegen. Beispiel:
pyenv(Version="3.13");Haben Sie eine nicht standardmäßige Installation durchgeführt und z. B. Python-Dateien auf Ihren Computer kopiert, ohne das Installationsprogramm auszuführen, legen Sie die Python-Version mithilfe des Pfads zur ausführbaren Python-Datei für die Basisumgebung oder virtuelle Umgebung fest. Beispiel:
pyenv(Version="C:\Users\username\AppData\Local\Programs\Python\Python313\python.exe");
pyenv gibt ein PythonEnvironment-Objekt mit Informationen zur aktuellen Python-Umgebung zurück.
PythonEnvironment with properties:
Version: "3.13"
Executable: "C:\Users\username\AppData\Local\Programs\Python\Python313\python.exe"
Library: "C:\Users\username\AppData\Local\Programs\Python\Python313\python313.dll"
Home: "C:\Users\username\AppData\Local\Programs\Python\Python313"
Status: NotLoaded
ExecutionMode: InProcess
Einstellen der Python-Version auf Mac und Linux
Um Einzustellen, welche Python-Version auf Mac und Linux verwendet werden soll, verwenden Sie das Namen-Wert-Paar Version von pyenv, um den vollständigen Pfad zur ausführbaren Python-Datei für die Basisumgebung oder virtuelle Umgebung anzugeben. Beispiel:
pyenv(Version="/usr/bin/python3.13")pyenv gibt ein PythonEnvironment-Objekt mit Informationen zur aktuellen Python-Umgebung zurück.
PythonEnvironment with properties:
Version: "3.13"
Executable: "/usr/bin/python3"
Library: "libpython3.13.so.1.0"
Home: "/usr"
Status: NotLoaded
ExecutionMode: InProcessVerwenden der Umgebungsvariable PYTHONHOME
So möglich, verwenden Sie den Fensterbereich „External Languages“ (Externe Sprachen) oder pyenv, um die Python-Version festzulegen. In Fällen, in denen der Fensterbereich oder pyenv nicht verwendbar ist, z. B. bei der Ausführung von MATLAB-Apps, können Sie die Version über die Umgebungsvariable PYTHONHOME festlegen. Falls Sie die Version über pyenv und PYTHONHOME einstellen, müssen die Versionen übereinstimmen.
Um den Wert der Umgebungsvariable anzuzeigen, geben Sie in der MATLAB-Eingabeaufforderung
getenv("PYTHONHOME")ein. Geben Siee = pyenv; e.Versionein, um die überpyenveingestellte Version anzuzeigen.Informationen zum Einstellen von
PYTHONHOMEfinden sie unterhttps://docs.python.org/3/using/cmdline.html#envvar-PYTHONHOME. Informationen zum Setzen von Umgebungsvariablen finden Sie in der Dokumentation Ihres Betriebssystems. Sie können die Variable auch mithilfe vonsetenvsetzen. Diese Einstellung gilt jedoch nur für die aktuelle MATLAB-Sitzung.Geben Sie
unsetenv("PYTHONHOME")ein, umPYTHONHOMEfür die aktuelle MATLAB-Sitzung zu löschen.
Ändern des Ausführungsmodus (optional)
Haben Sie die Python-Umgebung ausgewählt, lädt MATLAB den Python-Interpreter nicht unmittelbar. Der Ladevorgang wird ausgeführt, wenn Sie zum ersten Mal eine Python-Funktion in MATLAB aufrufen. Vor diesem ersten Aufruf können Sie optional den Ausführungsmodus für Python ändern. Sie können Python entweder im selben Prozess wie MATLAB (Modus InProcess) oder in einem eigenen Prozess (Modus OutOfProcess) ausführen.
Standardmäßig läuft Python im Modus
InProcess. Dieser Ausführungsmodus hat Leistungsvorteile und wird für die Ausführung von bestehendem Python-Code empfohlen.Wenn Sie Python-Code aktiv entwickeln, setzen Sie den Ausführungsmodus auf
OutOfProcess. Dieser Modus schützt Ihre MATLAB-Sitzung vor Abstürzen von instabilem Code und erlaubt es Ihnen, lange laufenden Python-Code über Strg+C zu unterbrechen. Der ModusOutOfProcessempfiehlt sich ebenfalls, wenn Sie Drittanbieter-Bibliotheken verwenden müssen, die mit MATLAB in Konflikt stehen.
Um den Ausführungsmodus festzulegen, klicken Sie im Fensterbereich „External Languages“ (externe Sprachen) auf die Schaltfläche „Settings“ (Einstellungen) und wählen Sie OutOfProcess aus. Alternativ können Sie in der MATLAB-Eingabeaufforderung pyenv(ExecutionMode="OutOfProcess") eingeben. Weitere Informationen finden Sie unter Out-of-Process Execution of Python Functionality.
Überprüfen, ob Python mit MATLAB funktioniert
Um zu überprüfen, ob Python mit MATLAB funktioniert, laden Sie den Python-Interpreter, indem Sie einen Python-Ausdruck in MATLAB eingeben. Beispiel:
py.list
ans =
Python list with values:
[]
Use string, double, datetime or cell function to convert to a MATLAB array.Wenn Sie die Fehlermeldung Unable to resolve the name py. erhalten, wobei myfuncmyfunc
MATLAB greift beim Laden des Python-Interpreters auf folgende Einstellungen zu:
Benutzereinstellungen für die Python-Umgebung, die mithilfe der
pyenv-Funktion konfiguriert werden. Falls die von Ihnen angegebene Version mit der von der UmgebungsvariablePYTHONHOMEangegebenen Version in Konflikt steht, löschen Sie die Umgebungsvariable, bevor Siepyenvaufrufen. Um die Umgebungsvariable zu löschen, geben Sie in die MATLAB-Eingabeaufforderungunsetenv("PYTHONHOME")ein. Der vonpyenvfestgelegte Wert ist über MATLAB-Sitzungen hinweg persistent. Weitere Informationen finden Sie unter Einstellen der Python-Version auf Windows oder Einstellen der Python-Version auf Mac und Linux.PYTHONHOME-Umgebungsvariable, die angibt, wo sich die Python-Standardbibliotheken befinden. MATLAB verwendet diese Variable nur, wennpyenv.Statusden WertNotLoadedaufweist. Geben Siegetenv("PYTHONHOME")ein, um den Wert der Variablen in MATLAB anzuzeigen. Weitere Informationen finden Sie unter Verwenden der Umgebungsvariable PYTHONHOME.Umgebungsvariable
PATH(Systempfad) Geben Siegetenv("PATH")ein, um den Systempfad in MATLAB anzuzeigen.Windows-Registry
Wechseln von Python-Umgebungen
Über den Fensterbereich „External Languages“ (Externe Sprachen) oder pyenv können Sie die von MATLAB verwendete Python-Umgebung wechseln. Der Prozess zum Wechseln der Python-Umgebung hängt vom Ausführungsmodus ab.
Wenn Python im
InProcess-Modus geladen wird, starten Sie zunächst MATLAB neu. Verwenden Sie daraufhin den Fensterbereich „External Languages“ (externe Sprachen) oderpyenv, um die Python-Umgebung zu wechseln.Wenn Python im Modus
OutOfProcessgeladen ist, beenden Sie zunächst den Python-Prozess, indem Sieterminate(pyenv)aufrufen. Verwenden Sie daraufhin den Fensterbereich „External Languages“ (Externe Sprachen) oderpyenv, um die Python-Umgebung zu wechseln.
Um eine alte Python-Umgebung aus dem Fensterbereich „External Languages“ (externe Sprachen) zu entfernen, rechtsklicken Sie in der Liste All Python Environments auf die Umgebung und wählen Sie Remove Environment aus. Wenn Sie eine Umgebung entfernen, wird sie nicht vom System gelöscht. Sie können sie später wieder hinzufügen. Sie können eine von einem MATLAB Support for Python Add-On installierte Umgebung nicht auf diese Weise entfernen. Um diese Umgebung zu entfernen, deinstallieren Sie das Supportpaket aus dem Fensterbereich „Add-Ons“ und aktualisieren Sie daraufhin mithilfe der Schaltfläche „Refresh“ (Aktualisieren) den Fensterbereich „External Languages“ (Externe Sprachen).
