Wie stelle ich eine Datei auf einen bestimmten Commit in Git zurück?

In der Versionskontrolle mit Git kommt es häufig vor, dass man eine Datei auf einen früheren Zustand zurücksetzen muss. Dies kann notwendig sein, wenn beispielsweise eine Datei versehentlich geändert wurde oder man die Änderungen eines bestimmten Commits wiederherstellen möchte. In diesem Artikel zeigen wir Ihnen, wie Sie eine Datei auf einen bestimmten Commit in Git zurücksetzen können, ohne das gesamte Projekt zurückzusetzen.

Was ist Git und warum sollten Sie eine Datei auf einen bestimmten Commit zurücksetzen?

Git ist ein verteiltes Versionskontrollsystem, das von Entwicklern weltweit verwendet wird, um Codeänderungen zu verwalten und zu verfolgen. Mit Git können Sie verschiedene Versionen Ihres Codes speichern und zu diesen zurückkehren, was die Zusammenarbeit und die Verwaltung von Projekten erheblich vereinfacht.

Es gibt jedoch Situationen, in denen Sie eine Datei auf einen früheren Zustand zurücksetzen müssen, ohne den gesamten Code oder den aktuellen Arbeitsstand zu verlieren. Dies kann besonders hilfreich sein, wenn Sie feststellen, dass eine Datei durch einen Fehler oder eine unerwünschte Änderung beeinflusst wurde, und Sie den Zustand einer früheren Version wiederherstellen möchten.

Wie funktioniert das Zurücksetzen einer Datei auf einen bestimmten Commit?

Git bietet mehrere Möglichkeiten, eine Datei auf einen früheren Zustand zurückzusetzen. Wir werden zwei häufige Methoden betrachten, mit denen Sie eine Datei auf einen bestimmten Commit zurücksetzen können:

  • git checkout
  • git restore

1. Methode: Zurücksetzen mit git checkout

Eine der einfachsten Methoden, um eine Datei auf einen bestimmten Commit zurückzusetzen, ist die Verwendung des git checkout-Befehls. Beachten Sie, dass git checkout in neueren Git-Versionen durch git restore ersetzt wurde, aber der Befehl funktioniert noch immer.

So setzen Sie eine Datei auf einen bestimmten Commit zurück:

git checkout  --

Ersetzen Sie <commit-hash> durch den Hash des Commits, auf den Sie zurücksetzen möchten, und <dateipfad> durch den Pfad der Datei, die Sie zurücksetzen möchten.

Beispiel: Angenommen, Sie möchten die Datei index.html auf den Commit mit dem Hash abc1234 zurücksetzen. Der Befehl würde folgendermaßen aussehen:

git checkout abc1234 -- index.html

Nachdem Sie diesen Befehl ausgeführt haben, wird die Datei auf den Zustand dieses Commits zurückgesetzt, und die Änderungen werden in Ihrem Arbeitsverzeichnis übernommen. Beachten Sie, dass der Befehl keine Änderungen an der Git-Historie vornimmt – er beeinflusst nur den aktuellen Zustand Ihrer Arbeitskopie.

2. Methode: Zurücksetzen mit git restore

Der git restore-Befehl wurde in neueren Git-Versionen eingeführt und ist eine modernere Methode, um Dateien zurückzusetzen. Der Vorteil von git restore besteht darin, dass er klarer und spezifischer ist als der alte git checkout-Befehl und sich besser für das Zurücksetzen einzelner Dateien eignet.

Um eine Datei mit git restore auf einen bestimmten Commit zurückzusetzen, verwenden Sie folgenden Befehl:

git restore --source=

Wie beim vorherigen Befehl geben Sie den Commit-Hash und den Dateipfad an. Beispiel:

git restore --source=abc1234 index.html

Mit diesem Befehl wird die Datei index.html auf den Zustand des Commits mit dem Hash abc1234 zurückgesetzt. Der Befehl wird jedoch nur die Datei im Arbeitsverzeichnis ändern, ohne den Commit-Verlauf zu beeinflussen.

Wie finde ich den Commit-Hash, den ich verwenden muss?

Um eine Datei auf einen bestimmten Commit zurückzusetzen, müssen Sie den Commit-Hash kennen. Der Commit-Hash ist eine eindeutige Kennung für jeden Commit, der in einem Git-Repository gemacht wurde.

Sie können den Commit-Hash leicht finden, indem Sie den Befehl git log verwenden:

git log

Dieser Befehl zeigt eine Liste aller Commits in Ihrem Git-Repository, einschließlich des Commit-Hashes, des Autors, des Datums und der Commit-Nachricht. Ein Beispiel für die Ausgabe von git log könnte folgendermaßen aussehen:

commit abc1234d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t
Author: Max Mustermann <max@beispiel.com>
Date:   Mon Dec 28 14:35:45 2024 +0100

    Fix bug in index.html

Der Commit-Hash ist der lange alphanumerische String, der nach dem Wort “commit” erscheint (z. B. abc1234d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t).

Was passiert, wenn ich eine Datei auf einen bestimmten Commit zurücksetze?

Das Zurücksetzen einer Datei auf einen bestimmten Commit hat keine Auswirkungen auf die Git-Historie oder den Rest des Repositories. Die Datei wird lediglich in Ihrem Arbeitsverzeichnis auf den Zustand des angegebenen Commits zurückgesetzt. Es gibt jedoch einige Dinge zu beachten:

  • Änderungen in der Datei werden überschrieben, wenn Sie die Datei auf einen früheren Zustand zurücksetzen.
  • Der Commit, auf den Sie die Datei zurücksetzen, wird nicht aus der Historie entfernt oder verändert.
  • Wenn Sie die Änderungen dauerhaft machen möchten, müssen Sie die Datei nach dem Zurücksetzen commiten.

Wenn Sie beispielsweise die Datei auf einen früheren Commit zurücksetzen und anschließend Änderungen daran vornehmen, können Sie diese Änderungen in einem neuen Commit speichern:

git add index.html
git commit -m "Restore index.html to commit abc1234"

Zusammenfassung

Das Zurücksetzen einer Datei auf einen bestimmten Commit in Git ist eine nützliche Funktion, um Fehler zu korrigieren oder frühere Versionen einer Datei wiederherzustellen. Mit den Befehlen git checkout oder git restore können Sie eine Datei ohne Auswirkungen auf die Git-Historie auf einen bestimmten Commit zurücksetzen. Wenn Sie die Änderungen dauerhaft speichern möchten, müssen Sie die Datei nach dem Zurücksetzen commiten.

Vergewissern Sie sich, dass Sie den richtigen Commit-Hash verwenden und die Änderungen entsprechend speichern, um die gewünschte Version Ihrer Datei zu behalten.