Git für Einsteiger: Versionskontrolle verständlich erklärt

Repository, Commit, Branch und Remote: die Grundbegriffe und ersten Befehle, mit denen Sie Git sicher im Alltag nutzen
Aktualisiert:
Abstract
- #Git
- #Versionskontrolle
- #Softwareentwicklung
- #Programmierung
- #Repositories
- #Commits
- #Branches
- #Merges
Schluss mit „bericht_final_v3_neu.docx“: wie Git jede Änderung nachvollziehbar macht und Teamarbeit am Code ordnet
Fast jeder kennt Ordner mit Dateien wie „angebot_v2.docx“, „angebot_v2_korrigiert.docx“ und „angebot_final_wirklich.docx“. Niemand weiß mehr genau, welche Fassung gilt, was sich zwischen zwei Versionen geändert hat und wer die Änderung gemacht hat. In der Softwareentwicklung wäre dieses Vorgehen schnell ruinös, denn ein Projekt besteht dort aus Hunderten Dateien, an denen mehrere Menschen gleichzeitig arbeiten.
Genau dafür gibt es Versionskontrolle. Das mit Abstand verbreitetste System ist Git. Es merkt sich jeden gespeicherten Zwischenstand, zeigt Unterschiede zwischen Fassungen an und erlaubt es, parallel an mehreren Ideen zu arbeiten, ohne sich gegenseitig zu stören. Dieser Einstieg erklärt die Grundbegriffe und die Befehle, mit denen Sie in den ersten Wochen auskommen.
Was Versionskontrolle leistet und warum Git sich durchgesetzt hat
Ein Versionskontrollsystem speichert nicht einfach Kopien von Dateien. Es zeichnet nachvollziehbar auf, welche Änderungen wann von wem und mit welcher Begründung gemacht wurden. Wer später wissen will, warum eine bestimmte Zeile im Code steht, findet die Antwort in der Historie.
Git entstand 2005. Linus Torvalds, der Begründer von Linux, entwickelte es, nachdem das bis dahin für den Linux-Kernel genutzte Werkzeug nicht mehr kostenlos zur Verfügung stand. Zwei Eigenschaften haben Git groß gemacht:
- Git ist verteilt. Jede Kopie eines Projekts enthält die komplette Historie. Sie können offline arbeiten, Änderungen speichern und vergleichen, ohne einen Server zu erreichen. Ältere, zentrale Systeme wie Subversion benötigen für Commits und den Blick in die Historie eine Verbindung zum Server.
- Branches sind billig. Eine neue Entwicklungslinie anzulegen, dauert Sekundenbruchteile. Das hat die Arbeitsweise ganzer Teams verändert.
Wichtig für Einsteiger ist die Abgrenzung: Git ist das Programm auf Ihrem Rechner. GitHub, GitLab, Bitbucket oder Forgejo sind Plattformen, auf denen Git-Projekte zentral liegen und um Funktionen wie Code-Reviews, Aufgabenverwaltung und automatische Tests ergänzt werden. Git funktioniert auch ganz ohne diese Dienste.
Die ersten Schritte: Installation und Einrichtung
Unter Linux steckt Git meist in den Paketquellen, unter macOS bringen es die Xcode-Kommandozeilenwerkzeuge mit, unter Windows installiert man „Git for Windows“ oder nutzt den Paketmanager winget. Danach sollte Git wissen, wer Sie sind, denn Name und E-Mail-Adresse stehen in jedem gespeicherten Zwischenstand:
git config --global user.name "Erika Mustermann"
git config --global user.email "erika.mustermann@example.com"
git config --global init.defaultBranch main
Die dritte Zeile legt fest, dass neue Projekte mit einem Hauptzweig namens main starten. Früher hieß dieser Zweig standardmäßig master. GitHub (seit 2020) und GitLab (seit 2021) legen neue Repositories mit main an, viele Projekte sind gefolgt. Git selbst verwendet ohne diese Einstellung noch den alten Namen und weist bei git init darauf hin; mit Git 3.0 soll auch dort main zum Standard werden. Ältere Anleitungen, die von master sprechen, bezeichnen also denselben Zweig.
Viele arbeiten nicht nur im Terminal, sondern auch mit der Git-Integration ihres Editors. Visual Studio Code etwa zeigt Änderungen farbig an und bietet Commits per Mausklick. Die Befehle im Hintergrund sind dieselben, deshalb lohnt es sich, sie zu verstehen. Tipps zur Editor-Integration enthält der Beitrag VS Code meistern.
Repository, Arbeitsverzeichnis und Staging-Bereich
Ein Repository, kurz Repo, ist ein Projektordner, dessen Geschichte Git verwaltet. Sie legen es mit einem einzigen Befehl an:
mkdir website
cd website
git init
Git erzeugt dabei einen versteckten Unterordner .git. Dort liegt die gesamte Historie. Diesen Ordner bearbeiten Sie nie von Hand; wer ihn löscht, löscht die Versionsgeschichte.
Für das Verständnis entscheidend sind drei Bereiche:
- Arbeitsverzeichnis: die Dateien, wie Sie sie gerade im Editor sehen und ändern.
- Staging-Bereich (auch Index genannt): eine Art Packtisch. Hier legen Sie fest, welche Änderungen in den nächsten Zwischenstand kommen.
- Repository: die gespeicherte Historie aller Zwischenstände.
Der Staging-Bereich irritiert anfangs, ist aber nützlich. Angenommen, Sie haben in einer Sitzung einen Tippfehler im Impressum korrigiert und gleichzeitig ein neues Kontaktformular begonnen. Mit dem Staging-Bereich können Sie beides getrennt speichern, sodass die Historie später sauber lesbar bleibt.
Den aktuellen Zustand zeigt jederzeit:
git status
Dieser Befehl ist der wichtigste für Einsteiger. Er verrät, welche Dateien geändert, welche vorgemerkt und welche Git noch unbekannt sind, und schlägt oft gleich den passenden nächsten Schritt vor.
Commits: Zwischenstände mit Begründung
Ein Commit ist ein gespeicherter Zwischenstand des Projekts. Er enthält die vorgemerkten Änderungen, Autor, Zeitpunkt, eine Nachricht und einen Verweis auf den vorherigen Commit. Jeder Commit erhält eine eindeutige Kennung, einen sogenannten Hash, eine lange Zeichenkette aus Ziffern und Buchstaben. Im Alltag genügen meist die ersten sieben Zeichen.
git add index.html
git commit -m "Startseite mit Kontaktdaten anlegen"
git add legt Änderungen auf den Packtisch, git commit speichert sie. Mit git add . lassen sich alle Änderungen im aktuellen Ordner auf einmal vormerken. Das ist bequem, sollte aber erst nach einem Blick auf git status passieren, damit keine unerwünschten Dateien hineinrutschen.
Die Historie zeigen diese beiden Befehle:
git log --oneline
git diff
git log listet die Commits, git diff die noch nicht gespeicherten Unterschiede zeilengenau.
Gute Commit-Nachrichten
Eine Commit-Nachricht richtet sich an Menschen, die den Code in einem halben Jahr verstehen müssen, oft an Sie selbst. „Fixes“ oder „Änderungen“ hilft niemandem. Besser ist eine kurze Zeile im Imperativ, die beschreibt, was der Commit bewirkt: „Anzeigefehler im Kontaktformular auf Mobilgeräten beheben“. Viele Teams einigen sich zusätzlich auf Konventionen, etwa Präfixe wie feat: oder fix:.
Was nicht ins Repository gehört
Eine Datei namens .gitignore im Projektordner listet Dateien und Ordner, die Git ignorieren soll: Build-Ergebnisse, Abhängigkeiten wie node_modules, Logdateien und vor allem lokale Konfigurationsdateien mit Passwörtern oder API-Schlüsseln.
node_modules/
dist/
.env
*.log
Das ist kein Detail. Zugangsdaten, die einmal in einem Commit gelandet sind, bleiben in der Historie, auch wenn die Datei später gelöscht wird. Ist so etwas passiert, hilft nur, den Schlüssel sofort zu ersetzen. Große Binärdateien wie Videos oder Designdateien sind in Git ebenfalls schlecht aufgehoben. Dafür gibt es die Erweiterung Git LFS (Large File Storage).
Branches: parallel arbeiten, ohne etwas zu gefährden
Ein Branch ist eine eigene Entwicklungslinie. Technisch ist er nur ein beweglicher Zeiger auf einen Commit, deshalb ist er so schnell angelegt. Der Zeiger HEAD markiert, auf welchem Branch Sie gerade arbeiten.
Angenommen, auf main liegt die funktionierende Website, und Sie möchten ein neues Newsletter-Formular ausprobieren. Statt direkt auf main zu arbeiten, legen Sie einen neuen Branch an und wechseln hinein:
git switch -c newsletter-formular
Alle Commits landen nun auf diesem Branch, main bleibt unberührt. Zurück geht es mit git switch main. Ältere Anleitungen verwenden dafür git checkout. Das funktioniert weiterhin, doch der Befehl erledigt sehr unterschiedliche Aufgaben und verwirrt Einsteiger leicht. Seit Version 2.23 bietet Git deshalb die klareren Befehle git switch für Branches und git restore für Dateien an.
Einen Überblick über alle Branches gibt git branch.
Merge und Konflikte: Arbeit zusammenführen
Ist das Formular fertig, wird es in den Hauptzweig übernommen:
git switch main
git merge newsletter-formular
Hat sich main in der Zwischenzeit nicht verändert, verschiebt Git einfach den Zeiger nach vorn (ein sogenannter Fast-Forward). Gab es auf beiden Seiten neue Commits, erzeugt Git einen Merge-Commit, der beide Linien vereint. Meist geschieht das automatisch.
Ein Konflikt entsteht, wenn auf beiden Branches dieselbe Stelle einer Datei unterschiedlich geändert wurde. Git kann dann nicht entscheiden, welche Fassung gilt, und markiert die Stelle in der Datei:
<<<<<<< HEAD
Öffnungszeiten: Montag bis Freitag, 9 bis 17 Uhr
=======
Öffnungszeiten: Montag bis Donnerstag, 8 bis 16 Uhr
>>>>>>> newsletter-formular
Sie entscheiden im Editor, welche Fassung bleibt oder ob beide kombiniert werden, entfernen die Markierungen und schließen den Vorgang mit git add und git commit ab. Konflikte sind kein Fehler, sondern normaler Teil der Teamarbeit. Wer häufig kleine Änderungen zusammenführt, hat seltener große Konflikte. Wie sich Branches in größeren Teams sinnvoll organisieren lassen, beschreibt der Infothek-Beitrag zu Branching-Strategien für Features und Releases.
Remote-Repositories: zusammenarbeiten über GitHub, GitLab und Co.
Bisher lag alles auf Ihrem Rechner. Für Teamarbeit und als Sicherung wird das Repository mit einer entfernten Kopie verbunden, einem Remote. Meist liegt es auf einer der genannten Plattformen oder auf einem eigenen Server.
Ein bestehendes Projekt holen Sie mit:
git clone https://github.com/beispiel/website.git
Die wichtigsten Befehle für den Austausch:
# eigene Commits hochladen (beim ersten Mal mit -u verknüpfen)
git push -u origin main
# neue Commits der anderen holen und einarbeiten
git pull
# nur nachsehen, was es Neues gibt, ohne einzuarbeiten
git fetch
origin ist der übliche Name für das Remote, von dem ein Projekt geklont wurde. Für die Anmeldung verlangen GitHub und Bitbucket SSH-Schlüssel oder Zugriffstoken; das Konto-Passwort reicht dort für Git-Befehle nicht mehr. Bei GitLab gilt das, sobald die Zwei-Faktor-Authentifizierung aktiv ist.
In vielen Teams wird nicht direkt auf main gepusht. Stattdessen laden Entwickler:innen ihren Branch hoch und eröffnen einen Pull Request (bei GitLab Merge Request). Kolleg:innen sehen sich die Änderungen an, automatische Tests laufen, und erst danach wird zusammengeführt. Das ist weniger ein Git-Befehl als eine Arbeitsweise, die Qualität und Wissensaustausch im Team fördert.
Fehler rückgängig machen, ohne Schaden anzurichten
Die Angst, etwas kaputtzumachen, hält viele Einsteiger zurück. Dabei ist mit Git fast alles reparierbar, solange es einmal committet wurde. Die gängigsten Fälle:
# Änderungen an einer Datei verwerfen (zurück zum letzten Commit)
git restore kontakt.html
# Datei aus dem Staging-Bereich nehmen, Änderung bleibt erhalten
git restore --staged kontakt.html
# einen bereits geteilten Commit durch einen Gegen-Commit aufheben
git revert a1b2c3d
git restore ohne weitere Option verwirft ungespeicherte Änderungen endgültig, hier ist Vorsicht angebracht. git revert ist der sichere Weg für Commits, die schon auf dem Server liegen, weil die Historie erhalten bleibt und nur ein neuer Commit hinzukommt. Der Befehl git reset kann dagegen Historie umschreiben. Auf Branches, die andere bereits nutzen, sollten Sie ihn meiden, solange Sie seine Varianten nicht sicher beherrschen.
Wer tiefer einsteigen möchte, etwa mit Aliasen, git reflog zum Wiederfinden scheinbar verlorener Commits oder besseren Werkzeugen für Konflikte, findet das im Beitrag Git richtig nutzen: Profi-Tipps jenseits der Standardbefehle.
Was Git für Ihr Team bedeutet
Git ist heute in der Softwareentwicklung Standard, und kaum ein Projekt kommt ohne aus. Doch auch außerhalb der Programmierung lohnt es sich: Dokumentationen, Konfigurationsdateien, Infrastrukturbeschreibungen oder technische Handbücher im Textformat profitieren von nachvollziehbarer Historie und Reviews. Für Word-Dokumente oder Tabellen ist Git weniger geeignet, weil es Unterschiede in Binärformaten nicht sinnvoll anzeigen kann.
Für Einsteiger gilt: Die hier gezeigten rund fünfzehn Befehle reichen für die meisten Alltagsaufgaben. Wer git status regelmäßig nutzt, kleine Commits mit verständlichen Nachrichten schreibt und für jede Aufgabe einen eigenen Branch anlegt, macht bereits vieles richtig. Überschätzt wird dagegen die Bedeutung exotischer Befehle. Für die meisten Teams ist ein gemeinsam vereinbarter Arbeitsablauf wichtiger als Spezialwissen Einzelner.
Gerade in gemischten Teams, in denen nicht alle täglich programmieren, entscheidet eine gute Einführung darüber, ob Git als Hilfe oder als Hürde empfunden wird. Für Teams, die Git strukturiert einführen oder ihre Kenntnisse vertiefen möchten, bieten wir Git-Schulungen und Workshops an, vom ersten Commit bis zu Branching-Strategien und Code-Reviews.
Häufige Fragen zu Git
Was ist der Unterschied zwischen Git und GitHub?
Git ist die Software zur Versionskontrolle, die lokal auf Ihrem Rechner läuft. GitHub ist ein Onlinedienst, der Git-Repositories speichert und um Zusammenarbeit, Reviews und Automatisierung ergänzt. Alternativen sind GitLab, Bitbucket oder selbst betriebene Lösungen wie Forgejo und Gitea.
Wie oft sollte man committen?
Immer dann, wenn ein sinnvoller, in sich abgeschlossener Schritt erreicht ist, etwa eine behobene Fehlerquelle oder ein fertiger Teil einer Funktion. Viele kleine Commits sind leichter zu prüfen und rückgängig zu machen als ein großer am Ende des Tages.
Kann man Git auch ohne Kommandozeile nutzen?
Ja. Editoren wie VS Code oder IntelliJ sowie Programme wie GitHub Desktop oder Sourcetree bieten grafische Oberflächen. Trotzdem lohnt es sich, die Grundbefehle zu kennen, denn Fehlermeldungen und Anleitungen beziehen sich fast immer darauf.
Was passiert, wenn zwei Personen dieselbe Datei bearbeiten?
Solange sie unterschiedliche Stellen ändern, führt Git die Änderungen automatisch zusammen. Nur wenn dieselben Zeilen betroffen sind, entsteht ein Konflikt, den eine Person von Hand auflöst.
Kategorien
Schlagworte