Am 08.09.2026 zeigt die offizielle Git-Installationsseite für macOS Git 2.55.0 als aktuelle Version. Prüfen Sie trotzdem zuerst mit git --version, ob Ihr Mac bereits eine verwendbare Git-Version aufruft. Für normale Programmierkurse wählen Sie danach zuerst die Xcode Command Line Tools. Installieren Sie Git über Homebrew nur, wenn Ihr Kurs oder ein konkretes Werkzeug eine neuere oder getrennt verwaltete Git-Version verlangt. Erst wenn Versionsprüfung, Identität und ein Test-Commit funktionieren, ist die Einrichtung wirklich abgeschlossen.
Zuletzt aktualisiert: 08.09.2026. Die Versionsangabe und Installationswege wurden anhand der offiziellen Git-Dokumentation geprüft; Befehle und Konfigurationsschritte wurden gegen die genannten Dokumentationen von Git, Apple und VS Code abgeglichen.
Diese Anleitung richtet sich an Sie, wenn Sie Git zum ersten Mal auf einem Mac verwenden und zwischen Command Line Tools und Homebrew schwanken. Sie ist auch für Lernende gedacht, die einen entfernten Mac oder einen Schulrechner nutzen und ihre Aufgaben sicher in einem Repository speichern möchten. Wenn VS Code bereits installiert ist, das Bedienfeld für die Quellcodeverwaltung aber Git nicht findet, können Sie die Prüfschritte direkt nachvollziehen.
01 Das Ergebnis vor der Installation
Stellen Sie sich Git wie ein digitales Aufgabenheft vor. Die Dateien sind Ihre Notizen, ein Commit ist ein gespeicherter Zwischenstand und ein Repository ist der Ordner, in dem diese Zwischenstände gesammelt werden. Der erste Fehler vieler Einsteiger besteht darin, sofort einen Installer zu starten. Das ist unnötig, wenn Git bereits vorhanden ist, oder verwirrend, wenn das Terminal einen anderen Pfad verwendet.
Öffnen Sie auf dem Mac zunächst das Programm „Terminal“. Apple beschreibt Terminal als die macOS-Anwendung, in der Sie Befehle textbasiert eingeben und ausführen können. Eine kurze Übersicht finden Sie in der Apple-Anleitung zu Terminal.
Geben Sie ein:
git --version
which git
Der erste Befehl fragt die Git-Version ab. Die genaue Bedeutung von git --version ist in der offiziellen Git-Dokumentation zum Versionsbefehl beschrieben. Der zweite Befehl zeigt, welche ausführbare Datei Ihre aktuelle Shell verwendet. Das ist wichtig: „Git ist installiert“ und „dieses Terminal verwendet die erwartete Git-Datei“ sind zwei verschiedene Aussagen.
Bewerten Sie die Ausgabe so:
- Erscheint eine Git-Version und ein Pfad, testen Sie zunächst einen Commit. Eine erneute Installation ist nicht automatisch nötig.
- Wird eine Installation der Xcode Command Line Tools angeboten, folgen Sie dieser Route, sofern Ihr Kurs keine besondere Versionsvorgabe enthält.
- Meldet das Terminal, dass der Befehl nicht gefunden wurde, installieren Sie die Command Line Tools und starten anschließend die Prüfung erneut.
- Weicht die angezeigte Version von der Kursvorgabe ab, vergleichen Sie zuerst die Anforderung. Die Bezeichnung „Git 2.55“ bedeutet nicht, dass jedes Installationsverfahren genau dieselbe Ausgabe liefern muss.
Hinweis: Die offizielle Seite nennt Git 2.55.0 für macOS. Ihre lokale Ausgabe kann davon abweichen. Maßgeblich sind die tatsächlich angezeigte Version, der verwendete Pfad und die Vorgaben Ihres Kurses.
02 Die passende Installationsroute
Xcode Command Line Tools als Standard für Einsteiger
Für eine normale Python-, Java- oder Frontend-Aufgabe ist die Apple-Entwicklungswerkzeugsammlung meist der einfachere Einstieg. Sie erhalten damit die Werkzeuge, die viele grundlegende Entwicklungsabläufe benötigen, ohne selbst eine komplette Entwicklungsumgebung zusammenzustellen. Die Git-Seite führt Xcode Command Line Tools ausdrücklich neben weiteren macOS-Installationswegen auf: offizielle Installationsoptionen für Git auf macOS.
Wenn macOS nach git --version ein Dialogfenster zur Installation öffnet, bestätigen Sie nur, wenn Sie den Vorgang bewusst gestartet haben. Warten Sie, bis die Installation beendet ist. Öffnen Sie danach ein neues Terminal-Fenster und führen Sie erneut aus:
git --version
which git
Das Ende des Installationsfensters ist noch kein Beweis für eine funktionierende Git-Umgebung. Der Nachweis besteht aus der Versionsausgabe und einem späteren Test-Commit.
Homebrew nur bei einer konkreten Anforderung
Homebrew ist ein Paketmanager. Er kann Werkzeuge installieren und verwalten, ist aber nicht automatisch die beste Wahl für einen ersten Git-Kurs. Wählen Sie diesen Weg, wenn Ihr Kurs eine bestimmte neuere Git-Version voraussetzt, Ihr Team dieselbe Paketverwaltung verwendet oder Sie mehrere Entwicklungswerkzeuge bewusst zentral verwalten möchten.
Verwenden Sie keine Installationszeile aus einem Forum, dessen Herkunft Sie nicht prüfen können. Installieren Sie keine Shell-Skripte mit Administratorrechten, wenn Sie nicht verstehen, was sie verändern. Besonders auf einem Schulgerät sollten Sie nicht versuchen, Gerätesperren, geschützte Systemordner oder fehlende Berechtigungen zu umgehen.
Nach einer Homebrew-Installation prüfen Sie nicht nur die Version, sondern auch den Pfad:
git --version
which git
Wenn weiterhin ein anderer Pfad erscheint, ruft Ihre Shell möglicherweise die bereits vorhandene Git-Version auf. Das ist kein Grund, wahllos Dateien zu löschen. Notieren Sie die Ausgabe und prüfen Sie anschließend Ihre Shell-Umgebung oder bitten Sie die Kursbetreuung um Hilfe.
| Entscheidungskriterium | Xcode Command Line Tools | Git über Homebrew |
|---|---|---|
| Geeignet für | Erste Kurse, einfache Aufgaben und typische VS-Code-Projekte | Bewusst verwaltete Werkzeugketten oder konkrete Versionsvorgaben |
| Aufwand für Einsteiger | Niedrig: Installationshinweis von macOS folgen und prüfen | Höher: Paketmanager, Pfad und Aktualisierung zusätzlich verstehen |
| Versionsentscheidung | Ergebnis nach der Installation kontrollieren | Ergebnis und verwendeten Pfad kontrollieren |
| Sicherheitsgrenze | Nur den offiziellen macOS-Dialog verwenden | Keine unbekannten Installationsskripte ausführen |
| Stoppen, wenn | Git-Version und Pfad sichtbar sind | Git-Version, Pfad und Kursanforderung zusammenpassen |
Die Tabelle ist eine Entscheidungshilfe, keine Zusage, dass jede Route auf jedem verwalteten Gerät verfügbar ist. Auf einem Schulrechner kann die Installation durch Administratorrechte eingeschränkt sein.
03 Identität, Branch und Authentifizierung
Benutzername und E-Mail-Adresse
Git speichert bei einem Commit einen Namen und eine E-Mail-Adresse als Metadaten. Diese Angaben gehören zur Commit-Identität. Sie sind nicht dasselbe wie das Passwort für eine Code-Plattform. Die Pro-Git-Dokumentation zur ersten Einrichtung beschreibt die grundlegenden Einstellungen.
Setzen Sie zunächst Werte für Ihr lokales Lernprojekt:
git config --global user.name "Ihr Name"
git config --global user.email "ihre-adresse@example.org"
git config --global init.defaultBranch main
Prüfen Sie danach die gespeicherten Werte:
git config --global --list
Sie müssen nicht automatisch Ihre private Adresse veröffentlichen. Nutzen Sie eine Adresse, die Sie für Ihre Kurs- oder Plattformkonten vorgesehen haben und deren Verwendung Sie datenschutzrechtlich vertreten können. Wenn Ihre Schule eine bestimmte Adresse verlangt, folgen Sie der Kursregel. Tragen Sie keine fremde Adresse ein, nur damit ein Commit „irgendwie funktioniert“.
Die Einstellung init.defaultBranch main legt den Namen des ersten lokalen Hauptzweigs für neu initialisierte Repositorys fest. Sie ändert keine bereits vorhandenen Projekte. Wenn Ihr Kurs einen anderen Branch-Namen vorgibt, verwenden Sie die Kursvorgabe.
Zugang zum entfernten Repository
Git-Konfiguration und Anmeldung sind getrennte Ebenen:
- Der Name und die E-Mail-Adresse erscheinen in Commit-Metadaten.
- HTTPS und SSH sind Verbindungswege zu einem entfernten Repository.
- Ein Passwort, Zugriffstoken oder privater SSH-Schlüssel darf nicht in eine Aufgabe, Chatnachricht oder fremde Datei kopiert werden.
Lesen Sie vor dem Verbinden die offizielle Dokumentation zu Authentifizierungsverfahren. Für persönliche Zugriffstoken gelten eigene Regeln, die in der Dokumentation zur sicheren Token-Verwendung beschrieben werden.
Speichern Sie Zugangsdaten nicht in einer .py-, .java- oder .js-Datei. Fügen Sie Token-Dateien auch nicht versehentlich zum Repository hinzu. Bei einem geteilten Schulrechner melden Sie sich nach der Arbeit ab und entfernen Sie keine Dateien, die der Geräteverwaltung gehören.
04 Der erste Test-Commit
Erstellen Sie einen kleinen, löschbaren Ordner. Verwenden Sie nicht sofort Ihr benotetes Kursprojekt. Dadurch können Sie die Einrichtung prüfen, ohne eine wichtige Datei zu verändern.
- Öffnen Sie Terminal.
- Erstellen Sie den Übungsordner und wechseln Sie hinein:
mkdir -p ~/git-test
cd ~/git-test
- Initialisieren Sie das Repository:
git init
Git erstellt damit die Verwaltungsstruktur für den Ordner. Die Grundlagen zu lokalen Repositorys erklärt die Pro-Git-Anleitung zu Repositorys.
- Erzeugen Sie eine harmlose Testdatei:
printf "# Git-Test\n" > README.md
- Prüfen Sie den Zustand:
git status
Die neue Datei sollte als nicht versioniert erscheinen. Das ist zunächst korrekt. Git sieht die Datei, verfolgt sie aber noch nicht.
- Nehmen Sie die Datei in den nächsten Zwischenstand auf:
git add README.md
git status
- Erstellen Sie den ersten Commit:
git commit -m "Erster Test-Commit"
- Prüfen Sie die Historie:
git log --oneline
Sie sollten nun einen Commit mit Ihrer konfigurierten Identität sehen. Kontrollieren Sie zusätzlich:
git status
Ein sauberer Zustand bedeutet, dass keine nicht gespeicherten Änderungen im Testordner übrig sind. Damit haben Sie nicht nur Git installiert, sondern auch die gesamte lokale Kette geprüft: Repository, Datei, Stage, Commit, Identität und Historie.
Erfahrungshinweis: Wenn der Commit wegen einer fehlenden Identität abbricht, ist Git nicht kaputt. Prüfen Sie
git config --global --list, korrigieren Sie Name oder E-Mail-Adresse und wiederholen Sie den Commit. Kopieren Sie keine Zugangsdaten in den Commit-Befehl.
05 VS Code und die tatsächliche Git-Verbindung
Öffnen Sie nun denselben Ordner in VS Code. Verwenden Sie die Funktion zum Öffnen eines Ordners und wählen Sie git-test. VS Code erkennt ein Repository normalerweise über den geöffneten Ordner und zeigt Änderungen im Bereich für Quellcodeverwaltung an. Die VS-Code-Übersicht zur Quellcodeverwaltung erklärt, wie der Editor lokale Änderungen und Repositorys darstellt.
Ändern Sie README.md, speichern Sie die Datei und beobachten Sie die Anzeige:
- Die Datei erscheint als geändert.
- Der Diff zeigt die neue Zeile.
- Sie können die Änderung für den Commit vormerken.
- Die Commit-Historie enthält nach dem Commit einen weiteren Zwischenstand.
Wenn VS Code Git nicht findet, prüfen Sie zuerst im integrierten Terminal:
git --version
which git
Schließen und öffnen Sie VS Code danach erneut. Vergleichen Sie den Pfad aus dem integrierten Terminal mit dem normalen Terminal. Eine unterschiedliche Shell-Umgebung kann erklären, warum ein Editor eine andere Git-Datei sieht. Die VS-Code-Anleitung zur Fehlerbehebung bei Git behandelt typische Erkennungsprobleme.
Installieren Sie Git nicht ein zweites Mal, bevor Sie diese Prüfung gemacht haben. Mehrere Installationen können die Pfadsuche unübersichtlich machen.
06 Sonderfälle auf Schul- und Remote-Macs
Fehlende Administratorrechte
Wenn Sie auf einem Schulrechner keine Software installieren dürfen, ist das eine Gerätebeschränkung und kein Git-Fehler. Fragen Sie die zuständige Betreuung nach einer freigegebenen Entwicklungsumgebung. Speichern Sie keine Kursdateien in nicht genehmigten Cloud-Ordnern und umgehen Sie keine Richtlinien.
Für ein Lernprojekt kann ein Remote-Mac sinnvoll sein, wenn Sie eine echte macOS-Umgebung benötigen, aber keinen eigenen Mac besitzen. Prüfen Sie vor dem Start, ob Sie Terminal öffnen, Git konfigurieren und Dateien exportieren dürfen. Bei CALMVPS können Sie sich zunächst über die verfügbaren Mac-Mietoptionen informieren. Der Blog ersetzt dabei keine Prüfung der konkreten Zugriffs- und Speicherbedingungen.
Projektablage vor dem Ablauf
Ein entfernter Mac ist kein Archiv. Bevor eine Mietperiode endet, müssen Sie Ihr Projekt an einen autorisierten Speicherort übertragen. Prüfen Sie mindestens:
- Ist der aktuelle Branch bekannt?
- Wurde der letzte Commit erstellt?
- Sind uncommittete Änderungen vorhanden?
- Liegt das Repository in einem freigegebenen entfernten Speicherort?
- Wurde der Export auf einem zweiten Gerät geöffnet?
- Wurden Token, private Schlüssel und lokale Zugangsdaten aus dem Export ausgeschlossen?
Ein sicherer Ablauf ist: git status ausführen, Änderungen bewusst committen, das Repository auf den vorgesehenen Speicherort übertragen und anschließend auf einem anderen Gerät kontrollieren. Wenn die Verbindung zum entfernten Repository noch nicht eingerichtet ist, exportieren Sie das Projekt nach den Regeln Ihres Kurses. Behalten Sie eine Kopie der reinen Quelldateien und eine getrennte Kopie der Versionshistorie, sofern Ihre Kursregeln das erlauben.
07 Zeitplan für die Kursfreigabe
Die folgenden vier Prüfungen sollten Sie abhaken, bevor Sie Ihr benotetes Projekt beginnen:
- [ ]
git --versionzeigt eine verwendbare Git-Version. - [ ]
which gitzeigt den von Ihnen erwarteten Pfad. - [ ]
git config --global --listenthält eine passende Identität. - [ ] Der Testordner enthält einen erfolgreichen Commit.
- [ ] VS Code erkennt Änderungen im geöffneten Repository.
- [ ] Das Projekt kann an einem autorisierten Speicherort gesichert werden.
- [ ] Auf einem Remote-Mac ist der Export vor dem Ablauf der Mietperiode geplant.
| Prüfpunkt | Erfolgsnachweis | Wenn der Nachweis fehlt |
|---|---|---|
| Git-Aufruf | Version und Pfad erscheinen im Terminal | PATH und Installationsroute prüfen |
| Identität | Name und E-Mail sind in der Git-Konfiguration sichtbar | Werte nach Kurs- und Datenschutzregeln korrigieren |
| Commit | git log --oneline zeigt einen Test-Commit |
Repository, Stage und Fehlermeldung einzeln prüfen |
| Editor | VS Code zeigt eine absichtlich geänderte Datei | Ordner öffnen, Git-Pfad prüfen und VS Code neu starten |
| Datensicherung | Projekt wurde an einem autorisierten Ort geöffnet | Export- und Zugriffsweg vor dem Kursstart testen |
Wenn Sie statt eines lokalen Macs einen entfernten Mac verwenden, testen Sie zuerst nur ein löschbares Projekt. Erst wenn Bearbeiten, Committen und Sichern funktionieren, übertragen Sie Ihre formale Kursaufgabe.
Für diesen Lernablauf hat eine vorhandene Windows- oder Schulumgebung drei typische Nachteile: Git oder VS Code dürfen eventuell nicht installiert werden, Administratorrechte fehlen, und lokale Dateien können beim Gerätewechsel schwerer kontrollierbar sein. Ein Remote-Mac von CALMVPS ist deshalb für einen zeitlich begrenzten Test eine mögliche Alternative, wenn Sie eine vollständige macOS-Umgebung mit eigenen Berechtigungen benötigen. Prüfen Sie die CALMVPS-Angebote für den Mac-Zugriff, wählen Sie aber erst nach einem erfolgreichen Test-Commit eine Mietdauer. Für langfristige, täglich intensive Arbeit oder Anforderungen an physische Anschlüsse kann ein eigener Mac die passendere Lösung sein.