HOWTO · Git

`git reset --soft` verwenden

Erfahren Sie, wie `git reset --soft` den Branch auf einen früheren Commit zurücksetzt und die Änderungen vorgemerkt lässt, damit Sie sie prüfen und sicher weiterbearbeiten können.

Auf dieser Seite

Mit git reset --soft <target> verschieben Sie die Spitze des aktuellen Branches auf einen früheren Commit, während Index und Arbeitsverzeichnis unverändert bleiben. Die Änderungen der übersprungenen Commits bleiben dadurch vorgemerkt und können erneut geprüft und committet werden. Das ist hilfreich, wenn Sie kürzlich erstellte Commits zusammenfassen oder ihre Nachrichten ändern möchten, ohne deren Inhalt zu verlieren.

Was git reset --soft ändert

Ein Soft Reset setzt HEAD und die Spitze des aktuellen Branches auf den angegebenen Commit. Der Staging-Index und die Dateien im Arbeitsverzeichnis bleiben unverändert. Daher sind die Änderungen zwischen der bisherigen Spitze und dem Ziel relativ zur neuen Spitze vorgemerkt. Der Befehl wirkt sich auf den aktuell ausgecheckten Branch aus; andere Branches, die auf den bisherigen Commit zeigen, werden nicht verschoben.

Geben Sie immer ein Ziel an, wenn Sie den Verlauf verschieben möchten. Lassen Sie es weg, verwendet Git HEAD; der Branch wird dann nicht verschoben. Bereits vorgemerkte oder noch nicht vorgemerkte Arbeit bleibt ebenfalls bestehen. Prüfen Sie anschließend den vorgemerkten Diff, damit klar ist, was der nächste Commit enthalten wird.

Den Commit auswählen, auf den zurückgesetzt werden soll

Sehen Sie sich mit git log --oneline den jüngsten Verlauf an. Wählen Sie den Commit aus, der zur Spitze des aktuellen Branches werden soll, und überprüfen Sie vor dem Reset seine Betreffzeile oder seinen Hash. HEAD~1 bezeichnet zum Beispiel den ersten Eltern-Commit des aktuellen Commits, also den vorherigen Commit auf der aktuellen Verlaufslinie. HEAD~2 geht zwei Schritte entlang der ersten Elternlinie zurück. Als Ziel können Sie auch einen Branch, ein Tag oder einen Commit-Hash angeben.

Das Ziel ist der Commit, der als Spitze erhalten bleiben soll, nicht der Commit, der entfernt werden soll. Ein Reset auf HEAD~1 verschiebt den Branch um einen Commit zurück; die Änderungen der bisherigen Spitze bleiben vorgemerkt. Wenn der Verlauf nicht linear ist, überprüfen Sie das Ziel im Log, statt anzunehmen, dass ein nummerierter Elternverweis den gewünschten Commit auswählt.

Commits zurücksetzen und Änderungen vorgemerkt lassen

Für einen einfachen Reset um einen Commit prüfen Sie zuerst das Log und führen dann git reset --soft HEAD~1 aus. Um mehrere kürzlich erstellte Commits zusammenzufassen, wählen Sie ein entsprechend weiter zurückliegendes Ziel, zum Beispiel git reset --soft HEAD~3. Index und Arbeitsverzeichnis bleiben erhalten, sodass die Änderungen dieser Commits gemeinsam für einen neuen Commit bereitstehen.

Führen Sie dieses Beispiel aus:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

work_dir="$(mktemp -d)"
trap 'rm -rf "$work_dir"' EXIT
cd "$work_dir"
git init -q
git config user.name "Example User"
git config user.email "example@example.com"
printf 'first version\n' > note.txt
git add note.txt
git commit -qm "Add note"
printf 'second version\n' > note.txt
git commit -qam "Update note"
git reset --soft HEAD~1
git status --short

Das Beispiel wird erfolgreich ausgeführt und gibt M note.txt aus. Damit wird bestätigt, dass die Änderung nach dem Soft Reset vorgemerkt bleibt. Der Code und die darin angezeigten Bezeichnungen und Ausgaben bleiben auf Englisch.

Die vorgemerkten Änderungen überprüfen

Prüfen Sie nach dem Reset mit git status, ob die vorgesehenen Dateien vorgemerkt sind. Mit git diff --cached sehen Sie den genauen vorgemerkten Patch, bevor Sie einen weiteren Commit erstellen. Die Option --cached vergleicht den Index mit HEAD, dem nun ausgewählten Ziel. Wenn die angezeigten Änderungen nicht Ihren Erwartungen entsprechen, halten Sie an und prüfen Sie vor dem Commit das Ziel und den Diff.

Ist der vorgemerkte Patch korrekt, erstellen Sie mit git commit -m "Describe the combined change" einen Ersatz-Commit. Um stattdessen den letzten Commit zu aktualisieren, ersetzt ihn git commit --amend; prüfen Sie den vorgemerkten Inhalt und die Commit-Nachricht sorgfältig, bevor Sie den Vorgang bestätigen. Ein Soft Reset erstellt nicht automatisch einen neuen Commit und ändert auch keine Commit-Nachrichten.

Wie sich --soft von --mixed und --hard unterscheidet

Alle drei Reset-Modi verschieben die Spitze des aktuellen Branches auf das Ziel, behandeln Index und Arbeitsverzeichnis jedoch unterschiedlich:

  • git reset --soft <target> verschiebt die Branch-Spitze und lässt Index und Arbeitsverzeichnis unverändert. Die betroffenen committeten Änderungen bleiben vorgemerkt.
  • git reset --mixed <target> verschiebt die Branch-Spitze und aktualisiert den Index passend zum Ziel, lässt die Dateien im Arbeitsverzeichnis aber unverändert. Änderungen der übersprungenen Commits sind danach nicht mehr vorgemerkt. --mixed ist der Standardmodus, wenn kein Modus angegeben wird.
  • git reset --hard <target> verschiebt die Branch-Spitze und bringt sowohl den Index als auch die getrackten Dateien im Arbeitsverzeichnis auf den Stand des Ziels. Getrackte Änderungen, die nicht im Ziel enthalten sind, können verworfen werden. Verwenden Sie diesen Modus daher nur, wenn genau das beabsichtigt ist.

Reset-Modi lassen in der Regel nicht betroffene, nicht getrackte Dateien unangetastet. git reset --hard kann jedoch eine nicht getrackte Datei oder ein Verzeichnis löschen, wenn es das Schreiben eines getrackten Pfads aus dem Ziel verhindert. Wählen Sie --soft, wenn die Änderungen für einen Ersatz-Commit vorgemerkt bleiben sollen, und --mixed, wenn Sie sie als nicht vorgemerkte Arbeit prüfen möchten. Verwenden Sie --hard nicht als Ersatz für einen Soft Reset.

Wann Sie git reset --soft sicher verwenden

Ein Soft Reset eignet sich, um den jüngsten lokalen Verlauf zu bearbeiten, etwa mehrere Commits zu einem zusammenzufassen oder ihre Änderungen für einen anderen Commit vorzubereiten. Prüfen Sie vor dem Ausführen mit git status und git log --oneline den aktuellen Branch und das Ziel. Kontrollieren Sie danach mit git status und git diff --cached die vorgemerkten Änderungen, damit Sie nicht versehentlich unabhängige vorgemerkte Arbeit einbeziehen.

Wenn die Commits bereits geteilt wurden, schreibt das Verschieben des Branches den Verlauf um, auf dem andere ihre Arbeit aufgebaut haben könnten. Stimmen Sie sich ab, bevor Sie einen geteilten Verlauf ändern. Soll eine veröffentlichte Änderung rückgängig gemacht werden, während der Verlauf erhalten bleibt, ist ein Revert in der Regel besser geeignet. Ein Soft Reset ändert nur das lokale Repository, bis Sie später pushen; das Pushen eines umgeschriebenen Verlaufs kann jedoch die Zusammenarbeit stören. Behalten Sie Ziel und vorgemerkten Diff im Blick und vermeiden Sie Force-Pushes als routinemäßigen Folgeschritt.