Schnellstart: Klonen eines Repositorys von Python-Code in Visual Studio

In dieser Schnellstartanleitung führen Sie die geführten Schritte aus, um ein GitHub-Repository von Python-Code zu klonen und ein Projekt zu erstellen. Visual Studio erleichtert das Arbeiten mit Python-Projekten mithilfe von Git-Befehlen, um auf Inhalte unter Quellcodeverwaltung zuzugreifen. Sie können python-Coderepositorys auch über die Befehlszeile klonen und dann mit den Projekten in Visual Studio arbeiten.

Voraussetzungen

• Visual Studio 2022 mit Unterstützung für Python-Workloads installiert. Visual Studio 2022 bietet eine nahtlose Integration mit GitHub mit Unterstützung für Git-Befehle. Weitere Informationen finden Sie unter Installieren der Python-Unterstützung in Visual Studio.

Visual Studio für Mac wird nicht unterstützt. Weitere Informationen finden Sie unter Was geschieht mit Visual Studio für Mac? Visual Studio Code unter Windows, Mac und Linux funktioniert gut mit Python über verfügbare Erweiterungen.

Klonen vorhandener Repositorydateien

Führen Sie die folgenden Schritte aus, um ein vorhandenes Repository mithilfe der Visual Studio Git-Quellcodeverwaltungsbefehle zu klonen:

1. Wählen Sie in Visual Studio Git>Clone aus:

   

2. Geben Sie im Dialogfeld " Repository klonen " das Zu klonende GitHub-Repository an:

   

   1. Geben Sie für den Speicherort des Repositorys die URL des Zu klonenden Repositorys ein. Geben Sie für diese Übung die Zeichenfolge https://github.com/gregmalcolm/python_koansein.

   2. Geben Sie für den Pfad den Ordner in Ihrem System ein, in dem Visual Studio die geklonten Dateien speichern soll.

      Der von Ihnen angegebene Ordner sollte der genaue Ordner sein, den Visual Studio verwenden soll. git clone Im Gegensatz zum Befehl erstellt Visual Studio beim Erstellen eines Klons im Team-Explorer nicht automatisch einen neuen Unterordner mit dem Namen des Repositorys.

   3. Wenn Sie fertig sind, wählen Sie Klonen aus.

   Nach Abschluss des Klons öffnet Visual Studio den Bereich "Git-Änderungen " für das Repository. Sie können den Ordner auch mit den geklonten Repositorydateien im Projektmappen-Explorer anzeigen.

3. Wählen Sie lokale> aus, und bestätigen Sie, dass sich das geklonte Repository jetzt in der Liste befindet:

   

Von Bedeutung

In dieser Schnellstartanleitung erstellen Sie einen direkten Klon des python_koans Repositorys auf GitHub. Ein solches Repository ist durch seinen Autor vor direkten Änderungen geschützt, sodass der Versuch, Änderungen am Repository zu übernehmen, fehlschlägt. In der Praxis verzweigen Entwickler stattdessen ein solches Repository in ihr eigenes GitHub-Konto, nehmen dort Änderungen vor und erstellen dann Pullanforderungen, um diese Änderungen an das ursprüngliche Repository zu übermitteln. Wenn Sie über einen eigenen Fork verfügen, verwenden Sie dessen URL anstelle der ursprünglich verwendeten Repository-URL.

Projekt aus geklonten Dateien erstellen

Nachdem Sie das Repository geklont haben, können Sie ein neues Projekt aus den geklonten Dateien erstellen.

Führen Sie die folgenden Schritte aus, um ein Projekt aus vorhandenen Dateien zu erstellen.

Von Bedeutung

Im folgenden Prozess werden keine ursprünglichen Quelldateien verschoben oder kopiert. Wenn Sie mit einer Kopie Ihrer Dateien arbeiten möchten, duplizieren Sie zuerst den Ordner, und erstellen Sie dann das Projekt.

1. Starten Sie Visual Studio, und wählen Sie "Neues>Projekt>" aus.

2. Suchen Sie im Dialogfeld " Neues Projekt erstellen " nach Python, und wählen Sie die Vorlage "Aus vorhandenem Python-Code " aus, und wählen Sie "Weiter" aus.

3. Geben Sie im Dialogfeld " Neues Projekt konfigurieren " einen Projektnamen und einen Speicherort ein, wählen Sie die Projektmappe aus, die das Projekt enthalten soll, und wählen Sie " Erstellen" aus.

4. Legen Sie im Assistenten " Neues Projekt aus vorhandenem Python-Code erstellen " den Ordnerpfad zu Ihrem vorhandenen Code fest, legen Sie einen Filter für Dateitypen fest, und geben Sie alle von Ihrem Projekt benötigten Suchpfade an, und wählen Sie dann "Weiter" aus. Wenn Sie die Suchpfade nicht kennen, lassen Sie das Feld leer.

   

5. Wählen Sie auf der nächsten Seite die Startdatei für Ihr Projekt aus. Visual Studio wählt den standardmäßigen globalen Python-Dolmetscher und die Standardversion aus. Sie können die Umgebung mithilfe des Dropdownmenüs ändern. Klicken Sie abschließend auf Weiter.

   Hinweis

   Im Dialogfeld werden nur Dateien im Stammordner angezeigt. Wenn sich die gewünschte Datei in einem Unterordner befindet, lassen Sie die Startdatei leer. Sie können die Startdatei im Projektmappen-Explorer festlegen, wie in einem späteren Schritt beschrieben.

   

6. Wählen Sie den Speicherort aus, an dem die Projektdatei (eine PYPROJ-Datei auf dem Datenträger) gespeichert werden soll. Falls zutreffend, können Sie auch die automatische Erkennung virtueller Umgebungen einschließen und das Projekt für verschiedene Webframeworks anpassen. Wenn Sie sich nicht sicher sind, dass diese Optionen aktiviert sind, lassen Sie die Felder auf die Standardwerte festgelegt.

   

7. Wählen Sie "Fertig stellen" aus.

   Visual Studio erstellt das Projekt und öffnet es im Projektmappen-Explorer. Wenn Sie die PYPROJ-Datei an einen anderen Speicherort verschieben möchten, wählen Sie die Datei im Projektmappen-Explorer aus, und wählen Sie dann auf der Symbolleiste " Datei>speichern unter " aus. Mit dieser Aktion werden Dateiverweise im Projekt aktualisiert, jedoch werden keine Codedateien verschoben.

8. Um eine andere Startdatei festzulegen, suchen Sie die Datei im Projektmappen-Explorer, klicken Sie mit der rechten Maustaste auf die Datei, und wählen Sie "Als Startdatei festlegen" aus.

Konfigurieren von Projekteigenschaften

Zum Ausführen des Projekts müssen Sie das Arbeitsverzeichnis für das Projekt identifizieren und Visual Studio mitteilen, welche Datei als Startdatei verwendet werden soll.

Führen Sie die folgenden Schritte aus, um Ihre Projekteigenschaften zu konfigurieren:

1. Erweitern Sie im Projektmappen-Explorer den Projektknoten, klicken Sie mit der rechten Maustaste auf die contemplate_koans.py Datei, und wählen Sie "Als Startdatei festlegen" aus. Mit dieser Aktion wird Visual Studio informiert, welche Datei zum Ausführen des Projekts verwendet werden soll.

2. Wählen Sie auf der Visual Studio-Hauptsymbolleiste Projekteigenschaften> aus, um die Eigenschaften für das Projekt zu öffnen.

3. Beobachten Sie auf der Registerkarte " Allgemein " den Wert des Arbeitsverzeichnisses für das Projekt.

   Standardmäßig legt Visual Studio das Arbeitsverzeichnis auf den Projektstamm (.). Beachten Sie, dass die Startdatei keinen bestimmten Ordnerspeicherort hat.

   

   Der geklonte Programmcode sucht nach einer Datei namens koans.txt im Arbeitsverzeichnis. Der Code erwartet, dass das Verzeichnis der Ordnerspeicherort ist, an dem Sie Visual Studio angewiesen haben, die geklonten Repositorydateien zu speichern. Wenn Sie das Arbeitsverzeichnis auf den Projektstamm. () festlegen, generiert das Programm Laufzeitfehler.

4. Legen Sie den Wert des Arbeitsverzeichnisses auf den Speicherort des Ordners des geklonten Repositorys fest, z. B. C:\Users\contoso\source\repos\Python-Koans.

   Tipp

   Eine schnelle Möglichkeit, den Ordnerspeicherort für die geklonten Dateien zu bestätigen, besteht darin, die Eigenschaften für die geklonte Datei im Projektmappen-Explorer zu überprüfen. Klicken Sie mit der rechten Maustaste auf die koans.txt Datei, und wählen Sie "Eigenschaften " aus, um den Detailbereich im Projektmappen-Explorer zu öffnen. Beachten Sie im Detailbereich, dass der Ordnerspeicherort für die Datei in der Eigenschaft "Vollständiger Pfad " aufgeführt ist. Sie können diesen Wert in das Feld "Arbeitsverzeichnis " auf der Seite "Projekteigenschaften " einfügen.

   

5. Speichern Sie Die Änderungen, und schließen Sie den Bereich " Projekteigenschaften ".

Ausführen des Python-Programms

Jetzt können Sie versuchen, die Anwendung für das neue Projekt auszuführen:

1. Wählen Sie Debug>Starten ohne Debuggen (oder verwenden Sie die Tastenkombination STRG+F5), um das Programm auszuführen.

   Wenn ein FileNotFoundError-Laufzeitfehler für die koans.txt Datei angezeigt wird, bestätigen Sie, dass das Arbeitsverzeichnis ordnungsgemäß festgelegt ist, wie im vorherigen Abschnitt beschrieben.

2. Wenn das Programm erfolgreich ausgeführt wird, wird in Zeile 17 der Projektdatei /koans/about_asserts.py ein Assertionsfehler angezeigt:

   

   Der Assertionsfehler ist beabsichtigt. Das Programm wurde entwickelt, um Python zu lehren, indem Sie alle beabsichtigten Fehler korrigieren. Weitere Informationen zum Programm finden Sie bei Ruby Koans, die Python Koans inspiriert haben.

3. Beenden Sie das Programm.

4. Doppelklicken Sie im Projektmappen-Explorer auf die Datei "/koans/about_asserts.py ", um die Datei im Editor zu öffnen:

   

   Zeilennummern werden standardmäßig nicht im Editor angezeigt. Um die Zeilennummern anzuzeigen, wählen Sie "Extras>Optionen" aus, erweitern Sie den Abschnitt "Alle Einstellungen>Language>Python>General ", und wählen Sie die Option " Zeilennummern " aus:

   

5. Korrigieren Sie den Fehler in der Datei "/koans/about_asserts.py ", indem Sie das False Argument in Zeile 17 in True" ändern. So sollte der aktualisierte Code aussehen:

   self.assertTrue(True) # This value should be True
   

6. Führen Sie das Programm erneut aus.

   Wenn Visual Studio vor Fehlern warnt, antworten Sie mit "Ja ", um den Code weiterhin auszuführen. Dieses Mal durchläuft das Programm die erste Prüfung und stoppt auf dem nächsten Koan. Sie können weiterhin weitere Fehler korrigieren und das Programm ausführen, um die Anpassungen anzuzeigen.

Verwandte Inhalte

• Klonen eines Git-Repositorys in Visual Studio
• Erstellen eines Git-Repositorys aus Visual Studio
• Lernprogramm: Arbeiten mit Python in Visual Studio