Wenn Sie'python' is not recognized as an internal or external commanddiesen Fehler sehen, bedeutet das, dass Windows die ausführbare Python-Datei nicht in der PATH-Umgebungsvariable finden kann.

Indem Sie das richtige Verzeichnis zu PATH hinzufügen, können Sie Python und pip in jedem Terminal ohne vollständige Pfade ausführen.

Bevor Sie beginnen, stellen Sie sicher, dass Folgendes vorhanden ist:

Voraussetzungen Beschreibung
Python installiert von python.org oder aus dem Microsoft Store unter Windows 11
Administratorrechte Erforderlich zum Ändern von Systemvariablen; Änderungen auf Benutzerebene erfordern keine Administratorrechte
Terminal neu starten Jede PATH-Änderung erfordert das erneute Öffnen einer neuen Terminalsitzung, um wirksam zu werden

Eine ausführliche Anleitung zu PATH, Installer-Optionen und Python Launcher finden Sie im Kapitel "Using Python on Windows" in der offiziellen Python-Dokumentation (docs.python.org).


Methode 1: PATH mit dem offiziellen Installer hinzufügen (empfohlen)

Der Installer von python.org kann PATH direkt für Sie einrichten, wodurch manuelle Eingabefehler vermieden werden, und er fügt außerdem den Scripts-Ordner hinzu, der für pip benötigt wird.

Derselbe Installer kann auch mit derModify-Option verwendet werden, um PATH zu einer bestehenden Installation hinzuzufügen, ohne sie neu zu installieren.

Schritte

Schritt Aktion
1 Laden Sie den Installer von python.org herunter und führen Sie ihn aus
2 Auf dem ersten Bildschirm:Aktivieren Sie dieOption "Add python.exe to PATH"
3 Klicken Sie bei einer Neuinstallation auf "Install Now"; wenn bereits installiert, wählen Sie "Modify" und aktivieren Sie diese Option
4 Nach Abschluss der Installation,schließen Sie dieEingabeaufforderung oder PowerShell und öffnen Sie sie erneut
5 Verwenden Sie den folgenden Befehl, um die Installation zu überprüfen

Installationsbildschirm — achten Sie darauf, die PATH-Option zu aktivieren:

Python 安装界面 - 勾选 Add python.exe to PATH

Wenn bereits installiert, wählen Sie die Modify-Option:

Python 安装程序 - Modify 选项

Überprüfen Sie, ob die Installation erfolgreich war:

python --version
pip --version
where python
where pip

命令行验证 Python 安装

CMD 终端截图

Wenn Sie Python bereits installiert haben, aber die PATH-Option damals nicht aktiviert haben, führen Sie einfach den Installer erneut aus, wählen SieModify, aktivieren Sie dann "Add python.exe to PATH", und öffnen Sie das Terminal nach Abschluss der Installation erneut.


Methode 2: Python manuell zu PATH hinzufügen (Benutzerebene)

Wenn Sie die PATH-Option bei der Installation von Python nicht aktiviert haben oder nur die Umgebungsvariablen des aktuellen Benutzers anpassen möchten, ohne Systemvariablen zu beeinflussen, können Sie PATH manuell bearbeiten.

Schritte

Schritt Aktion Beschreibung
1 drückenWin+R, Entersysdm.cpl, Enter drücken Das Fenster „Systemeigenschaften“ öffnen
2 Zum Tab „Erweitert“ wechseln und auf „Umgebungsvariablen“ klicken Die Oberfläche zum Bearbeiten der Umgebungsvariablen aufrufen
3 Im Bereich „Benutzervariablen“ auswählenPath, auf „Bearbeiten“ klicken Nur den PATH des aktuellen Benutzers ändern, ohne das System zu beeinflussen
4 Auf „Neu“ klicken und das Python-Installationsverzeichnis hinzufügen Zum BeispielC:\Users\用户名\AppData\Local\Programs\Python\Python311
5 Erneut auf „Neu“ klicken und dasScriptsUnterverzeichnis Am Ende desselben Pfades aus dem vorherigen Schritt hinzufügen\Scripts
6 Verwende "Move Up", um die neuen Einträge an den Anfang der Liste zu verschieben Stelle zuerst sicher, dass sie vom System gefunden werden
7 Klicke in jedem Dialogfeld auf "OK", um zu speichern Lass kein Dialogfeld aus
8 Schließe alle Terminalfenster vollständig und öffne sie erneut PATH-Änderungen werden in bereits geöffneten Terminals nicht wirksam
9 Führe den Verifizierungsbefehl aus Bestätige, dass sowohl python als auch pip korrekt funktionieren

Schritt 1 — Systemeigenschaften über sysdm.cpl öffnen:

运行 sysdm.cpl

Schritt 2 — Fenster „Umgebungsvariablen“:

系统属性 - 环境变量

Schritt 3 — Die Path-Variable bearbeiten:

编辑环境变量 - Path

Schritt 4 — Einen neuen Eintrag für den Python-Installationspfad erstellen:

新建 PATH 条目 - Python 安装目录

Schritt 5 — Scripts-Verzeichnis hinzufügen:

新建 PATH 条目 - Scripts 目录

Schritt 6 — Einträge nach oben verschieben, damit sie zuerst gefunden werden:

上移 PATH 条目

Schritt 7 — Alle Dialogfelder bestätigen und speichern:

确认保存环境变量

Schritt 9 — Das Ergebnis überprüfen:

python --version
pip --version
where python
where pip

验证 PATH 配置结果

Hinweise und häufige Fallstricke

Häufige Fehler Korrekte Vorgehensweise
Abschließender Backslash im Pfad Sollte verwendet werdenC:\Path\To\Python311, nichtC:\Path\To\Python311\
Zusätzliche Leerzeichen vor dem Pfad Jeder Eintrag sollte eine saubere Pfadzeile ohne führende oder abschließende Leerzeichen sein
Alte Einträge, die auf ungültige Ordner verweisen Nicht existierende Pfade löschen oder korrigieren, um Verwirrung bei der Pfadauflösung zu vermeiden
Terminal nach der Änderung nicht neu gestartet Schließen Sie alle Terminalfenster vollständig und öffnen Sie sie erneut; in manchen Fällen müssen Sie sich abmelden oder neu starten

Methode 3: "App-Ausführungsaliase" für Microsoft Store-Installationen reparieren

Wenn Sie Python aus dem Microsoft Store installiert haben, ist es auf "App-Ausführungsaliase" und das WindowsApps-Verzeichnis angewiesen, um den Befehl python aufzulösen, statt auf die traditionelle PATH-Bearbeitung.

Schritte

Schritt Aktion
1 Öffnen Sie WindowsEinstellungen, suchen Sie nach "App-Ausführungsaliase verwalten"
2 Findpython.exeundpython3.exedie Umschalter für:Einschalten, um den Alias zu aktivieren,Ausschalten, um Konflikte mit der python.org-Version zu vermeiden
3 Stellen Sie sicher, dass der Benutzer-PATH Folgendes enthält%USERPROFILE%\AppData\Local\Microsoft\WindowsApps
4 Öffnen Sie das Terminal erneut und führen Sie die Überprüfung durch

Eintrag für App-Ausführungsaliase in den Einstellungen:

管理应用执行别名设置

Alias-Umschalter für python.exe und python3.exe:

应用执行别名开关

Wenn die Eingabe vonpythonden Microsoft Store öffnet, anstatt Python auszuführen, verweist der Alias auf den Store. Deaktivieren Sie den Alias für die entsprechende Version, installieren Sie stattdessen die python.org-Version oder verwenden Sie den unten beschriebenen Python Launcher (Befehl py).


Methode 4: Verwenden Sie den Python Launcher anstelle der Bearbeitung von PATH

Python Launcher(py.exe) wird mit python.org-Builds installiert und kann installierte Python-Versionen automatisch anhand von Labels finden, wodurch PATH-Konflikte vollständig vermieden werden.

Dies ist die offiziell empfohlene Lösung zur Verwaltung mehrerer Versionen — du kannst für jedes Projekt eine bestimmte Python-Version festlegen, ohne PATH zu ändern.

Schritte

Launcher-Version prüfen:

py --version

py --version 命令

Gewünschte Python-Version explizit ausführen:

py -3
py -3.11
py -3.10 -m pip --version

py 指定 Python 版本

Launcher verwenden, um virtuelle Umgebungen zu erstellen und zu nutzen:

# 使用指定版本创建虚拟环境
py -3.11 -m venv venv

# 激活虚拟环境
venv\Scripts\activate

# 在虚拟环境中确认 Python 版本
python --version

py 创建虚拟环境

Zusätzliche Hinweise

Befehl Zweck
py --list Alle erkannten Python-Laufzeitversionen auflisten
py -3.11 Interaktiven Interpreter der angegebenen Python-Version starten
py -3.11 -m pip install 包名 Drittanbieter-Pakete für die angegebene Python-Version installieren

Wenn du den py-Launcher verwendest, kannst du die manuelle PATH-Bearbeitung vollständig überspringen. Der Launcher erkennt automatisch alle installierten Python-Versionen und lässt dich nach Bedarf wählen — das ist besonders praktisch für Entwickler, die sowohl Python 3.10 als auch 3.12 benötigen.


Schnelle Überprüfung und Fehlerbehebung

Bestätigen, welche ausführbare Datei ausgeführt wird

where python
where python3
where py

where 命令查看可执行文件位置

pip und Scripts überprüfen

pip --version
where pip

验证 pip 命令

Häufige Fehlerbehebung

Problem Lösung
EingabepythonÖffnen Sie dann den Microsoft Store Deaktivieren Sie unter "App-Ausführungsaliase" den entsprechenden Alias, oder wechseln Sie zupyBefehlszeilenstart
PATH-Änderungen werden nicht wirksam Schließen Sie alle Terminals und IDEs (z. B. VS Code) vollständig, und melden Sie sich bei Bedarf ab und wieder an
Konflikte zwischen mehreren Python-Versionen Verwenden Sie Python Launcher (py), um Versionen präzise auszuwählen, kombiniert mit virtuellen Umgebungen, um Projektabhängigkeiten zu isolieren

Zusammenfassung

Sobald PATH korrekt gesetzt ist – oder Sie anfangen, Python Launcher zu verwenden – können Sie Python und pip von überall ausführen, ohne den vollständigen Pfad einzugeben.

Für Umgebungen mit mehreren Versionen wird dringend empfohlen, Python Launcher zu verwenden, um Versionen präzise auszuwählen, kombiniert mit virtuellen Umgebungen, um die Abhängigkeitsisolierung für jedes Projekt aufrechtzuerhalten.

Option Anwendungsszenario Empfehlungsstufe
Offizieller Installer mit aktiviertem PATH Erstinstallation oder Neuinstallation von Python Höchste
Benutzer-PATH manuell bearbeiten Bereits installiert, aber PATH-Konfiguration verpasst Mittel
App-Ausführungsalias Microsoft-Store-Version von Python Niedrig (kollidiert leicht mit anderen Versionen)
Python-Launcher (py) Koexistenz mehrerer Versionen, projektbezogene Versionsverwaltung Höchste