Git Clone Branch: Ein Schritt-für-Schritt-Tutorial

Kurze Antwort: Wie man einen bestimmten Zweig klont

Um einen bestimmten Zweig aus einem Git-Repository zu klonen, verwendest du den Befehl:

git clone --single-branch --branch <branch_name> <repository_url>

Ersetze durch den Namen des gewünschten Zweigs und durch die URL des Repositorys. Dieser Befehl erstellt eine lokale Kopie des angegebenen Zweigs und ermöglicht die sofortige, gezielte Entwicklung in diesem Zweig.

Beispiel

In diesem Artikel verwenden wir dieses Repository. Damit kannst du die erlernten Befehle an deinem Rechner ausprobieren. Das Repository enthält drei Zweige:

1. main: Der Standardzweig mit zwei Textdateien.
2. add-new-file: Ein Zweig, dem eine dritte Datei hinzugefügt wurde.
3. modify-file: Ein Zweig, in dem die zweite Datei geändert wurde.

So können wir den Zweig klonen add-new-file:

git clone --single-branch --branch add-new-file https://github.com/fran-aubry/git-clone-example.git

Was ist git clone?

In der Standardeinstellung kopiert git clone das gesamte Repository in ein neues Verzeichnis auf deinem lokalen Rechner und klont dabei alle Zweige. Hier ist die Syntax:

git clone <repository_url>

Um das Beispiel-Repository zu klonen, können wir wie folgt vorgehen:

git clone https://github.com/fran-aubry/git-clone-example.git

Nachdem du diesen Befehl ausgeführt hast, werden alle Zweige auf deinen lokalen Rechner kopiert. Allerdings sind immer nur die Dateien eines Zweigs sichtbar, nämlich des ausgecheckten Zweigs. Nach dem Klonen eines Repositorys wird der Standardzweig (normalerweise main oder master genannt) ausgecheckt.

Wechselnde Zweige

Nach einem vollständigen Klon können wir mit dem Befehlgit checkout in den gewünschten Zweig wechseln (auschecken) . Um zum Beispiel den modify-file Zweig auszuchecken, müssen wir Folgendes tun:

git checkout modify-file

Klontiefe

Wenn du mit Git arbeitest, werden Änderungen an einem Zweig gespeichert, indem du sie mit dem Befehl git commit übermittelst. Jede Übergabe erzeugt einen neuen Zustand des Zweigs, zu dem du später bei Bedarf zurückkehren kannst. Stell dir vor, dass jeder Commit einen Lernpfad erzeugt und Git alle diese Lernpfade speichert. Du kannst einen Zweig jederzeit auf einen dieser Snapshots zurücksetzen.

Der Befehl git clone lädt, wenn er ohne Optionen verwendet wird, jeden Commit eines jeden Zweigs auf deinen lokalen Rechner herunter. Je nach Größe des Projekts kann dies eine beträchtliche Menge an Platz in deinem örtlichen Lager einnehmen. Wenn du weißt, dass du nicht die gesamte Historie benötigst, kannst du mit dem Parameter --depth angeben, wie viele Commits (oder Snapshots) du klonen möchtest .

Um den Hauptzweig zu klonen und dabei nur den letzten Commit zu laden, verwendest du den folgenden Befehl:

git clone --depth=1 https://github.com/fran-aubry/git-clone-example.git

Einen bestimmten Zweig klonen

Wir haben gelernt, wie man ein Repository mit git cloneklont . Standardmäßig klont dieser Befehl alles auf deinen lokalen Rechner. Oft möchtest du nur an einem bestimmten Zweig arbeiten, daher ist es effizienter, nur diesen Zweig zu klonen. Diese Vorgehensweise spart Speicherplatz und ermöglicht es dir, sofort mit der Arbeit zu beginnen, ohne nach dem Klonen den Zweig wechseln zu müssen.

Um es mit dem Schreiben eines Buches zu vergleichen: Stell dir vor, du wirst mit der Überarbeitung des zweiten Kapitels eines Buches beauftragt. In diesem Fall solltest du nur den Zweig klonen, in dem diese Aufgabe ausgeführt wird, da es nicht nötig ist, auf Zweige zuzugreifen, die mit der Überarbeitung anderer Kapitel zu tun haben.

Du kannst git anweisen, einen einzelnen Zweig zu klonen, indem du die Argumente --single-branch und --branch hinzufügst, gefolgt von dem Namen des Zweigs:

git clone --single-branch --branch <branch_name> <repository_url>

Lasst uns den Befehl aufschlüsseln:

• git clone: Dies ist der grundlegende Git-Befehl, um ein Repository von einer entfernten Quelle auf deinen lokalen Rechner zu kopieren.

• --single-branch: Mit dieser Option wird Git angewiesen, nur einen einzigen Zweig zu klonen. Wenn kein Zweig angegeben wird, wird der Standardzweig geklont.

• --branch : Diese Option gibt den zu klonenden Zweig an. Die <branch_name> ist der Name des Zweigs, den du klonen willst.
• : Dies ist die URL des Repositorys.

Um zum Beispiel nur die modify-file Zweig aus unserem Repository zu klonen, können wir Folgendes tun:

git clone --single-branch --branch add-new-file https://github.com/fran-aubry/git-clone-example.git

Wie man mit einem geklonten Zweig arbeitet

Wenn du einen Zweig bearbeitest, gibt es drei wichtige Vorgänge, die du erledigen musst:

1. Speichere deine aktuelle Arbeit, indem du einen Schnappschuss des aktuellen Zustands erstellst.
2. Lade deine Änderungen hoch, damit alle darauf zugreifen können.
3. Herunterladen der Änderungen anderer und Zusammenführen mit deinen eigenen.

Speichern Sie Ihre Änderungen mit git commit

In Git wird das Speichern deiner Arbeit als Commit bezeichnet. Bei diesem Vorgang wird ein Schnappschuss des aktuellen Zustands des Zweigs erstellt, an dem du gerade arbeitest.

Der Status der Verzweigung wird nach jeder Übergabe auf deinem lokalen Rechner gespeichert, sodass du zwischen den verschiedenen Stadien des Fortschritts navigieren kannst.

Um deine Änderungen in Git zu übertragen, verwendest du den Befehl git commit. Bevor du deine Änderungen überträgst, muss Git jedoch wissen, welche Dateien du in die Übertragung aufnehmen möchtest. Du gibst die zu speichernden Dateien mit dem Befehl git add an. Die Syntax für diesen Befehl lautet wie folgt:

git add <path_to_file>

In der Syntax ist der Pfad zu der Datei, die du übertragen willst. Wenn wir uns zum Beispiel im Zweig modify-file unseres Beispiel-Repositorys befinden und einen Absatz zu file2.txt hinzugefügt haben, fügst du diese Datei mit dem Befehl

git add file2.txt

Nachdem du alle Dateien hinzugefügt hast, die du in deine Übergabe einbeziehen möchtest, kannst du mit der Übergabe fortfahren, indem du ausführst:

git commit -m <message>

Hier sollte das Argument eine kurze, in Anführungszeichen gesetzte Nachricht sein, die die Änderungen kurz beschreibt. Zum Beispiel:

git commit -m "Add paragraph"

Hier sind einige Konventionen für die Commit-Nachricht. Sie sind wichtig, um Klarheit und Verständnis bei allen Projektbeteiligten zu schaffen:

• Verwende die imperative Stimmung: Beginne deine Commit-Nachricht mit einem Verb in der Imperativform (z.B. "Hinzufügen", "Beheben", "Aktualisieren"). Schreibe zum Beispiel statt "Neue Funktion hinzugefügt" "Neue Funktion hinzufügen".
• Sei prägnant, aber beschreibend: Bemühe dich um eine kurze Nachricht, idealerweise weniger als 50 Zeichen. Achte bei der Beschreibung der Änderungen jedoch auf Klarheit. Schreibe statt "Geänderte Sachen" lieber "Aktualisiere das Styling der Navigationsleiste".
• Vermeide generische Nachrichten: Vermeide vage Aussagen wie "Behebe Fehler" oder "Mach Verbesserungen". Sei stattdessen konkret: "Behebe einen Fehler in der Validierung des Anmeldeformulars" oder "Verbessere die Lesbarkeit der Dokumentation".

Hochladen deiner Änderungen mit git push

Wenn du eine Übertragung durchführst, erstellst du einen Schnappschuss der Änderungen auf deinem lokalen Rechner. Damit andere auf deine Änderungen zugreifen können, musst du sie hochladen. Dazu verwendest du den Befehl push.

Die grundlegende Syntax des Push-Befehls in Git lautet:

git push <remote> <branch>

Lass uns das mal aufschlüsseln:

• : Dies ist der Name des entfernten Repositorys, in das du deine Änderungen übertragen möchtest. Wenn du ein Repository klonst, wird das entfernte Repository standardmäßig als origin bezeichnet.
• : Dies ist der Name des Zweigs, dessen Änderungen du in das entfernte Repository übertragen willst. Wenn du dieses Argument weglässt, schiebt Git Änderungen auf der Grundlage des aktuellen Zweigs und der Konfigurationen für das Remote-Tracking.

Hier sind einige häufige Anwendungsfälle für git push:

• Änderungen aus dem aktuellen Zweig pushen: git push
• Die Änderungen aus einem bestimmten Zweig pushen: git push origin

Herunterladen von Änderungen mit git pull

Git ermöglicht es großen Teams, gleichzeitig an einem Projekt zu arbeiten. Wenn Kollegen denselben Zweig bearbeiten, an dem du arbeitest, kann dein lokaler Zweig im Vergleich zum entfernten Zweig veraltet sein.

Um die Commits anderer Leute herunterzuladen, verwenden wir den Befehl git pull. Die grundlegende Syntax des Push-Befehls in Git lautet:

git pull <remote> <branch>

Hier erfährst du, was die einzelnen Parameter bewirken:

• : Dies ist der Name des entfernten Repositorys, aus dem du ziehen möchtest. In der Standardeinstellung heißt dieses Repository origin.
• : Dies ist der Name des Zweigs, aus dem du Änderungen ziehen möchtest. Wenn nichts angegeben wird, verwendet git den aktuellen Zweig zusammen mit dem Upstream-Zweig.

Hier sind einige häufige Anwendungsfälle von git pull:

• Ziehen von Änderungen aus dem aktuellen Zweig: git pull
• Ziehen der Änderungen aus einem bestimmten Zweig: git pull origin

Commit-pull-push Workflow

Wenn du Git verwendest, empfehle ich dir, regelmäßig Updates zu ziehen, damit dein lokaler Zweig auf dem neuesten Stand bleibt. Ich empfehle, die folgenden Best Practices zu befolgen:

• Bevor du mit deiner Arbeit beginnst, solltest du die neuesten Updates für deinen aktuellen Zweig herunterladen, um sicherzustellen, dass du mit der aktuellsten Version arbeitest.
• Übertrage oft und achte darauf, dass sich jeder Commit auf kleine, logisch zusammenhängende Änderungen konzentriert.
• Nachdem du einige Änderungen vorgenommen und einen Commit erstellt hast, ziehe erneut, um deinen Zweig zu aktualisieren, falls jemand anderes zur gleichen Zeit Änderungen vorgenommen hat.
• Pushe schließlich deine Änderungen in das Remote-Repository.

Git-Konflikte

Wenn du den Befehlgit pull ausführst , um Änderungen aus einem entfernten Repository herunterzuladen, kann es vorkommen, dass ein anderer Commit die gleichen Zeilen wie deine lokalen Commits geändert hat. Git versucht, Änderungen automatisch zusammenzuführen, und in vielen Fällen gelingt das auch. Wenn zum Beispiel Änderungen an verschiedenen Teilen derselben Datei vorgenommen werden, kann Git diese nahtlos zusammenführen, weil die Commits unterschiedliche Abschnitte betreffen.

Wenn du und ein anderer Mitwirkender jedoch denselben Absatz bearbeitet haben, kann Git nicht feststellen, welche Version beibehalten werden soll, was zu einem Merge-Konflikt führt. In diesem Fall musst du den Konflikt manuell auflösen, indem du entscheidest, welche Änderungen beibehalten werden sollen.

Für weitere Anleitungen zum Auflösen von Konflikten empfehle ich diesen Artikel zu lesen wie man Merge-Konflikte in Git auflöst.

GitHub Download

In bestimmten Szenarien möchtest du eine lokale Kopie eines Repositorys verwenden, ohne es verändern zu wollen. Wenn es sich um ein öffentliches Repository handelt, musst du Git nicht auf deinem lokalen Rechner installieren. Du kannst das Repository direkt von GitHub herunterladen, indem du auf die Schaltfläche Code und anschließend auf die SchaltflächeDownload Zip klickst, wie unten gezeigt:

Fazit

Mit dem Git-Cloning kannst du ein Git-Repository auf deinen lokalen Rechner kopieren, um den Code zu nutzen oder ihn um neue Funktionen zu erweitern. Beim Klonen eines Repositorys werden alle Zweige heruntergeladen, was eine beträchtliche Menge an Speicherplatz beanspruchen kann.

Zweige werden verwendet, um an bestimmten Änderungen oder Funktionen zu arbeiten. Wenn du einen bestimmten Zweig klonst, kannst du dich an den Änderungen beteiligen, ohne andere Arbeiten herunterzuladen, wodurch du viel weniger Speicherplatz benötigst und deine lokale Festplatte sauberer bleibt.

Wenn du mehr über das Thema erfahren möchtest, empfehle ich dir dieses GitHub und Git Tutorial für Einsteiger.