Git で削除されたコミットを特定して復元する方法

はじめに

Git は強力なバージョン管理システムであり、開発者が変更を追跡し、共同作業を行い、プロジェクトの包括的な履歴を維持するのに役立ちます。ただし、開発者が誤って重要なコミットを削除してしまい、貴重なコードやプロジェクトの履歴が失われることがあります。このチュートリアルでは、Git で削除されたコミットを特定して復元するプロセスを案内し、失われたコードを回復し、プロジェクトの完全なコミット履歴を維持できるようにします。

Skills Graph

Git コミットの理解

Git は分散型バージョン管理システムであり、開発者がコードベースの変更を経時的に追跡することを可能にします。Git の核心はコミットという概念であり、これは特定の時点におけるプロジェクトの状態のスナップショットを表します。

Git コミットとは何か？

Git コミットは、Git リポジトリにおける変更の基本単位です。プロジェクトのファイルに変更を加え、それらの変更を保存することを決定すると、新しいコミットが作成されます。各コミットには以下の情報が含まれています。

1. 一意の識別子：すべてのコミットには、コミットハッシュまたはコミット SHA として知られる 40 文字の 16 進数の一意の文字列が割り当てられます。この識別子は、コミットを一意に参照するために使用されます。
2. 作者：変更を加え、コミットを作成した人。
3. タイムスタンプ：コミットが作成された日付と時刻。
4. コミットメッセージ：コミットで行われた変更の簡単な説明。
5. ファイルのスナップショット：コミット時点におけるプロジェクトディレクトリ内のすべてのファイルの完全な状態。
6. 親コミット：現在のコミットが基づいている前のコミット。

Git コミットの構造

Git リポジトリで新しいコミットを作成すると、以下の手順が実行されます。

1. 変更をステージする：まず、git add コマンドを使用して、コミットに含めたい変更をステージする必要があります。
2. コミットを作成する：変更がステージされたら、git commit コマンドを使用して新しいコミットを作成できます。これにより、プロジェクトの現在の状態がキャプチャされ、新しいコミットが作成されます。
3. ブランチを更新する：新しいコミットが現在のブランチに追加され、ブランチのポインタが新しいコミットに進みます。

コミット履歴の表示

git log コマンドを使用して、Git リポジトリのコミット履歴を表示できます。これにより、リポジトリ内のすべてのコミットのリストが表示され、コミットハッシュ、作者、タイムスタンプ、コミットメッセージが含まれます。

$ git log
commit 1234567890abcdef1234567890abcdef12345678
Author: John Doe <[email protected]>
Date:   Mon Apr 24 12:34:56 2023 +0000

    Implement new feature X

commit fedcba0987654321fedcba0987654321fedcba
Author: Jane Smith <[email protected]>
Date:   Fri Apr 21 09:87:65 2023 +0000

    Fix bug in module Y

削除されたコミットの特定

ソフトウェア開発の過程で、開発者が誤って Git リポジトリからコミットを削除してしまうことは珍しくありません。これらの削除されたコミットを特定することは、すべての Git ユーザーにとって重要なスキルです。

Git リフログ (reflog) の理解

Git リフログ (reflog) は、削除されたコミットを特定して復元するのに役立つ強力なツールです。リフログは、コミットの削除を含む、リポジトリのブランチ参照に対して行われたすべての変更のログです。

リフログを表示するには、git reflog コマンドを使用できます。

$ git reflog
1234567 HEAD@{0}: commit: Implement new feature X
fedcba0 HEAD@{1}: commit: Fix bug in module Y
abcd123 HEAD@{2}: commit: Update documentation

リフログの各エントリは、コミットハッシュ、変更の種類（例: commit）、および簡単な説明を含む、リポジトリの状態の変更を表しています。

削除されたコミットの特定

リフログを使用して削除されたコミットを特定するには、コミットが削除されたことを示すエントリを探すことができます。たとえば、次のようなエントリがある場合:

abcd123 HEAD@{2}: commit (amend): Update documentation

これは、ハッシュが abcd123 のコミットが以前に修正された（つまり、変更されて新しいコミットに置き換えられた）ことを意味します。

あるいは、次のようなエントリがある場合もあります。

abcd123 HEAD@{2}: commit (delete): Update documentation

これは、ハッシュが abcd123 のコミットがリポジトリから削除されたことを示しています。

リフログを調べることで、削除されたコミットのコミットハッシュを特定し、次のセクションで説明するようにそれを使用してコミットを復元することができます。

削除されたコミットの復元

Git リフログ (reflog) を使用して削除されたコミットを特定した後、そのコミットを復元してリポジトリに戻すことができます。このプロセスには、新しいブランチを作成するか、コミットを現在のブランチにチェリーピック (cherry-pick) することが含まれます。

削除されたコミットの復元

削除されたコミットを復元するには、git checkout コマンドを使用して、削除されたコミットを基に新しいブランチを作成できます。

$ git checkout -b restored-commit abcd123
Switched to a new branch 'restored-commit'

これにより、ハッシュが abcd123 の削除されたコミットを指す restored-commit という名前の新しいブランチが作成されます。その後、必要に応じてこのブランチで作業を続けることができます。

あるいは、git cherry-pick コマンドを使用して、削除されたコミットの変更を直接現在のブランチに適用することもできます。

$ git cherry-pick abcd123
[master 1234567] Update documentation
 Date: Wed Apr 26 10:23:45 2023 +0000
 1 file changed, 2 insertions(+)

これにより、ハッシュが abcd123 のコミットの変更が現在のブランチ（この例では master）に適用されます。

復元されたコミットの確認

削除されたコミットを復元した後、git log コマンドを使用して、コミットが正常に復元されたことを確認できます。

$ git log
commit 1234567890abcdef1234567890abcdef12345678
Author: John Doe <[email protected]>
Date:   Wed Apr 26 10:23:45 2023 +0000

    Update documentation

commit fedcba0987654321fedcba0987654321fedcba
Author: Jane Smith <[email protected]>
Date:   Fri Apr 21 09:87:65 2023 +0000

    Fix bug in module Y

復元されたコミットは、コミット履歴に表示されるはずです。

注意事項

Git リフログは、デフォルトでは直近 30 日間の情報しか保存しません。削除されたコミットが 30 日以上前のものである場合、リフログにはそのコミットが存在しない可能性があり、この方法では復元できないことがあります。

また、削除されたコミットが既にリモートリポジトリにプッシュされており、リモートリポジトリが更新されている場合、ローカルリポジトリから削除されたコミットを復元できないことがあります。このような場合、チームと協力してリモートリポジトリから削除されたコミットを復元する必要があるかもしれません。

まとめ

このチュートリアルでは、Git で削除されたコミットを効果的に特定して復元する方法を学びました。利用可能なさまざまな手法とコマンドを理解することで、失われたコードを回復し、完全なコミット履歴を維持し、プロジェクトの開発プロセスの整合性を確保することができます。Git の堅牢なバージョン管理機能は、現代のソフトウェア開発において不可欠なツールとなっており、削除されたコミットを管理する能力を習得することは、Git を使用するすべての開発者にとって貴重なスキルです。