Git

Git in der Bereichsleiste#

Befindet sich ein Bereich in einem Repository, zeigt seine obere Leiste den aktuellen Branch, wie viele Commits voraus (↑) und zurück (↓) sind und wie viele Dateien geändert wurden. Daneben:

Branch-Name

Öffnet die Branch-Liste: zuerst lokale Branches, dann solche, die nur remote existieren. Klicke auf einen Branch (oder drücke Enter), um zu wechseln. Gib einen Namen ein, den es noch nicht gibt, und drücke Enter, um den Branch zu erstellen und zu ihm zu wechseln. Branches, die in einem anderen Worktree ausgecheckt sind, sind markiert und nicht auswählbar.

Diff

Öffnet die nicht committeten Änderungen im Ordner dieses Bereichs, ohne das Git-Fenster zu öffnen.

Worktree

Erstellt einen Worktree für dieses Repository. Siehe Worktrees.

Commit

Öffnet den Dateistatus des Git-Fensters mit fokussiertem Nachrichtenfeld.

Fetch / Pull / Push

Pull ist hervorgehoben, wenn es etwas zu holen gibt. Ohne Upstream wird vom Standard-Branch des Remotes gepullt (z. B. origin/main); der Tooltip nennt die Quelle. Push erscheint, wenn du nicht gepushte Commits hast.

Das Git-Fenster#

Klicke in der Werkzeugleiste auf Git oder drücke Cmd/Ctrl+E, um das Git-Fenster für das Repository des fokussierten Terminals zu öffnen. Das Badge in der Werkzeugleiste zeigt, wie viele Dateien geändert wurden. Schließe es mit Esc, der Schaltfläche × oder erneut mit Cmd/Ctrl+E. Ziehe die Ränder, um die Größe zu ändern; ein Doppelklick auf einen Griff setzt sie zurück.

Auf der linken Seite wechselst du zwischen Dateistatus, Verlauf, Suche, Worktrees, Issues und Pull Requests; außerdem stehen dort Branches (nach / in Ordner gruppiert), Remotes und Tags. Klicke auf eine Referenz, um ihren Commit im Verlauf anzuzeigen; doppelklicke auf einen Branch, um ihn auszuchecken.

Änderungen prüfen und committen#

1. Öffne das Git-Fenster. Es startet im Dateistatus und listet jede nicht committete Datei mit Status und Zeilenzahlen auf.
2. Klicke auf eine Datei, um ihren Diff mit Zeilennummern zu sehen. Entferne das Häkchen bei Dateien, die nicht in diesen Commit sollen.
3. Schreibe eine Nachricht in Commit-Nachricht. Hake Nach dem Commit pushen an, um sofort zu pushen.
4. Klicke auf Commit oder drücke Cmd/Ctrl+Enter.

Alle Änderungen öffnet den Diff des gesamten Arbeitsverzeichnisses in einem größeren Viewer. Lange Zeilen werden dort umbrochen, und du kannst den Rand der Dateiliste ziehen, um sie zu verbreitern.

Den Verlauf durchsuchen#

Verlauf zeichnet einen Commit-Graphen über alle lokalen und Remote-Branches und Tags. Wähle einen Commit, um darunter seine Dateien und seinen Patch zu sehen. Suche filtert nach Nachricht, Autor oder Hash.

Rechtsklick auf einen Commit → Auf diesen Commit zurücksetzen... setzt den Branch auf diesen Commit zurück. Spätere Commits verlassen den aktuellen Verlauf, und nicht committete Änderungen an versionierten Dateien werden verworfen (nicht versionierte Dateien bleiben), daher wirst du vorher um Bestätigung gebeten.

Pull, Push, Fetch und Stash#

Pull

Wähle, welcher Remote-Branch in den aktuellen gepullt werden soll – ohne den Branch zu wechseln.

Push

Pusht den aktuellen Branch und setzt beim ersten Push seinen Upstream.

Fetch

Holt Aktualisierungen von allen Remotes.

Stash

Legt die Änderungen einschließlich nicht versionierter Dateien in den Stash (git stash push -u).

Wenn Git nicht ausgeführt werden kann#

Verhindert etwas auf deinem Computer, dass git funktioniert, nennt PATerminal den Grund und zeigt die einzeilige Lösung – mit Im Terminal eingeben, um sie einzufügen (Enter drückst du selbst), oder Kopieren. Erkannt werden eine nicht akzeptierte Xcode-Lizenz, fehlende Command Line Tools, ein nicht installiertes Git, ein Ordner, der einem anderen Benutzer gehört („dubious ownership“), und die Pfadlängenbeschränkung von Windows.