Git初心者必見！「git reset」と「git revert」の使い分け方

この記事の目的

この記事の主な目的は「git reset （ギット リセット）」と「git revert（ギット リバート）」の基本的な使い方と、それぞれの適切な使用シチュエーションを理解してもらうことです。エンジニア初心者や、これからGitを学び始める方を主なターゲットとしていますので、専門的な用語はできるだけ避け、わかりやすい言葉で説明していきます。

Gitの基本概念のおさらい

ここでは、Gitの中心的な概念である「コミット」や「リポジトリ」と「ワークツリー」の関係について、簡単におさらいします。

コミットとは

コミットは、Gitにおける変更履歴の一つの単位として考えることができます。ファイルやディレクトリのある時点でのスナップショットを指し、コミットを行うことでその時点での変更内容や変更した人、変更日時などの情報が記録されます。

コミットID

それぞれのコミットには一意のIDが割り当てられており、これを用いて特定のコミットを参照することができます。

親コミット

前のコミットを指し、変更履歴を辿ることができます。

リポジトリとワークツリーの関係

「リポジトリ」と「ワークツリー」は、Gitの操作を行う上で非常に重要な概念です。

リポジトリ

Gitによって管理されているプロジェクトのデータや変更履歴が保存されている場所を指します。リポジトリには、コミットされたデータやブランチ情報、タグなどが含まれています。

ワークツリー

リポジトリの最新のコミットの内容が展開されているディレクトリを指します。実際にファイルの編集や追加、削除を行う場所です。

リポジトリとワークツリーの間でのデータの移動や同期を行うために、git addやgit commitなどのコマンドを使用します。ワークツリーでの変更をリポジトリに保存することで、変更履歴を確実に記録することができます。

「git reset」の解説

git resetは、Gitで非常に強力なコマンドの一つとして知られています。このコマンドを使うことで、特定のコミットに戻ったり、ステージングエリアの変更を取り消すことができます。しかし、その強力さゆえに、誤った使い方をすると大きなトラブルを引き起こす可能性もあります。そこで、このセクションではgit resetの正しい使い方と、それぞれのオプションの違いについて解説します。

「git reset」コマンドの基本的な説明

git resetは、主に以下の3つの目的で使用されます。

• ステージングエリアの変更を取り消す
• あるコミットに戻る
• 過去のコミットを完全に削除する

「git reset」主なオプションの解説

git resetにはいくつかのオプションがありますが、ここでは最も一般的に使用される--soft、--mixed、--hardの3つのオプションに焦点を当てて解説します。

「git reset」使用シチュエーションとメリット・デメリット

「git revert」の解説

git revertは、Gitで行った変更を取り消すためのコマンドですが、git resetとは異なり、変更を取り消すための新しいコミットを生成する点が特徴です。このセクションでは、git revertの基本的な使い方やその特性、使用シチュエーションについて詳しく解説します。

「git revert」コマンドの基本的な説明

git revertコマンドは、特定のコミットの変更を取り消す新しいコミットを作成します。これにより、過去のコミットを取り消すことができる一方で、その取り消し自体の履歴も残るため、変更履歴を維持することができます。

revertが生成する新しいコミットについて

git revertを実行すると、指定したコミットの変更を取り消す内容を持つ新しいコミットが生成されます。この新しいコミットには、取り消された変更に関する情報や、revertコマンドを実行したユーザーの情報、日時などが記録されます。

「git revert」使用シチュエーションとメリット・デメリット

コミット内容やコメントを整理する際にも使用されます。squashについてはこちらの記事で詳しく解説しています。

https://envader.plus/article/268

「git reset」と「git revert」の主な使い分け

git resetとgit revertはGitで行った変更を取り消すためのコマンドですが、それぞれ異なるシチュエーションでの使用が推奨されています。ここではそれぞれのコマンドが適しているシチュエーションの例と、実務でのベストプラクティスについて解説します。

それぞれのコマンドが適しているシチュエーション

git reset

• ローカルの履歴を修正したい場合: 例えば、コミットメッセージのミスを修正する、または特定の変更を含めたり除外したりする場合等
• リモートにプッシュしていないコミットを取り消したい場合: プッシュする前に間違ったコミットをしてしまった場合等

git revert

• リモートにプッシュしたコミットを安全に取り消したい場合: 他の人と共同で作業しているときや、公開リポジトリでの作業時等
• 取り消し自体の履歴も残したい場合: 何が変更されたのか、どの変更が取り消されたのかの履歴を残しておきたい場合

実務でのベストプラクティス

リモートにプッシュしたコミットはgit resetで取り消さない

他の開発者との履歴の不整合を避けることができます。リモートのコミットを取り消す場合は、git revertを使用してください。

変更の取り消しは早めに行う

長い時間が経過してから変更を取り消すと、コンフリクトが発生する可能性が高まります。

コマンドの使用前には必ず現在のブランチやステータスを確認する

誤ったブランチやコミットで操作を行わないように注意してください。

実践編: よくあるシチュエーションでの対処法

日常の開発作業中、Gitを使用していると様々なシチュエーションに直面することがあります。ここでは、よくあるシチュエーションとその対処法を具体的に解説します。

間違ったコミットをした場合

対処法

1. まだリモートにプッシュしていない場合は、git resetを使用して直前のコミットを取り消すことができます。

   git reset HEAD~1

2. リモートにプッシュしてしまった場合は、git revertを使用して新しいコミットを生成し、間違ったコミットを取り消します。

   git revert [コミットのハッシュ]

過去のコミットに戻りたい場合

対処法

1. 一時的に過去のコミットを確認したいだけの場合は、以下のコマンドで過去のコミットにチェックアウトできます。

   git checkout [コミットのハッシュ]

2. 完全に過去のコミットに戻り、それ以降のコミットを取り消したい場合は、git resetを使用します。

   git reset --hard [コミットのハッシュ]

公開リポジトリでの誤操作の修正方法

対処法

1. 公開リポジトリで誤ったコミットをプッシュしてしまった場合、git revertを使用してそのコミットを取り消すのがベストプラクティスです。

   git revert [コミットのハッシュ]

2. 取り消したいコミットが連続している場合は、範囲を指定してgit revertを実行することができます。

   git revert [古いコミットのハッシュ]..[新しいコミットのハッシュ]

これらの方法でGitでの作業中に発生する様々な問題を効果的に解決することができます。適切なコマンドを選択し、安全な操作を心がけましょう。

まとめと次のステップ

本記事ではGitの基本的な操作であるgit resetとgit revertの使い方と使い分けについて詳しく解説しました。これらのコマンドは日常の開発作業で発生する様々な問題を解決するための強力なツールです。

Gitはソフトウェア開発における変更履歴の管理やチームでの協力を効率的に行うためのツールです。適切なコマンドの選択と使用方法を理解することで、開発の効率化やチームワークの向上に大きく貢献します。特にエラーや誤操作から迅速に回復する能力は、開発者としての信頼性や生産性を向上させる重要な要素となるため確実にマスターしたい所です。

さらなる学習のためのリソースや参考文献の紹介

Gitの学習は基本的なコマンドの理解から始まりますが、深く探求することでさらなる知識やスキルを獲得できます。以下はGitに関する学習のためのおすすめのリソースや参考文献です。

• Pro Git: Gitの公式ドキュメントで、初心者から上級者までの内容が詳しく解説されています。
• サル先生のGit入門: タスク管理ツールBacklogによるGitの日本語解説です。
• GitHub Learning Lab: 実践的なハンズオン形式でGitやGitHubの操作を学ぶことができるリソースです。
• Git Magic: Gitの内部構造や高度な操作に関する詳細なガイドブックです。

Gitを活用して、効率的かつ安全な開発を行いましょう。「慣れ」も大事ですので自信がつくまでコマンドを練習するといいかもしれません。