7.6 Gitツール - 履歴の書き換え

最新のコミットを変更することは、おそらく最も一般的な履歴の書き換えです。最新のコミットに対して、主に2つの基本的な操作を行う必要があります。コミットメッセージを変更するか、ファイルの追加、削除、変更によってコミットの実際のコンテンツを変更することです。

最後のコミットメッセージを修正するだけであれば、簡単です。

上記の命令は、前のコミットメッセージをエディターセッションに読み込みます。そこで、メッセージを変更し、変更を保存して終了できます。エディターを保存して閉じると、エディターは、更新されたコミットメッセージを含む新しいコミットを作成し、それを最新のコミットにします。

一方、最新のコミットの実際の内容を変更したい場合は、基本的に同じ手順で進めます。最初に、忘れたと思われる変更を行い、それらの変更をステージングし、その後のgit commit --amendによって、最新のコミットが新しく改良されたコミットに置き換えられます。

この手法には注意が必要です。修正によってコミットのSHA-1が変更されるためです。これは非常に小さなrebaseのようなものです。既にプッシュ済みの最新のコミットは修正しないでください。

履歴のさらに後ろにあるコミットを変更するには、より複雑なツールに移動する必要があります。Gitには履歴変更ツールがありませんが、rebaseツールを使用して、一連のコミットを、別のコミットに移動するのではなく、元のベースになっていたHEADにrebaseできます。対話型rebaseツールを使用すると、変更したい各コミットの後で停止し、メッセージを変更したり、ファイルを追加したり、任意の操作を実行できます。git rebaseに-iオプションを追加して、対話的にrebaseを実行できます。どのコミットをrebaseの対象とするかをコマンドに指示することで、履歴をどの程度遡って書き直すかを指定する必要があります。

たとえば、最後の3つのコミットメッセージ、またはそのグループ内のコミットメッセージを変更する場合は、編集したい最後のコミットの親であるHEAD~2^またはHEAD~3をgit rebase -iの引数として指定します。最後の3つのコミットを編集しようとしているため、~3の方が覚えやすいかもしれませんが、実際には4つ前のコミット、つまり編集したい最後のコミットの親を指定していることに注意してください。

繰り返しますが、これはrebaseコマンドです。変更されたメッセージを含む範囲HEAD~3..HEAD内のすべてのコミットとそのすべての子孫が書き換えられます。既に中央サーバーにプッシュ済みのコミットを含めないでください。そうすると、同じ変更の代替バージョンを提供することになり、他の開発者を混乱させることになります。

このコマンドを実行すると、テキストエディターに次のようなコミットのリストが表示されます。

これらのコミットは、通常logコマンドを使用して表示される順序とは逆順で表示されることに注意することが重要です。logを実行すると、次のような結果が表示されます。

逆順であることに注目してください。対話型rebaseは、実行しようとしているスクリプトを提供します。コマンドライン（HEAD~3）で指定したコミットから開始し、これらのコミットで導入された変更を上から下へ再生します。最も古いコミットが最初に表示されるのは、それが最初に再生されるためです。

スクリプトを編集して、編集したいコミットで停止するようにする必要があります。そのためには、編集したい各コミットの「pick」という単語を「edit」という単語に変更します。たとえば、3番目のコミットメッセージのみを変更するには、ファイルを次のように変更します。

エディターを保存して終了すると、Gitはリストの最後のコミットまで巻き戻し、次のメッセージとともにコマンドラインに移動します。

これらの指示は、何をすべきかを正確に示しています。次のコマンドを入力します。

コミットメッセージを変更し、エディターを終了します。次に、次のコマンドを実行します。

このコマンドにより、他の2つのコミットが自動的に適用され、作業が完了します。複数の行で「pick」を「edit」に変更すると、変更を「edit」に変更した各コミットに対してこれらの手順を繰り返すことができます。毎回、Gitは停止し、コミットを修正し、終了したら続行します。

対話型rebaseを使用して、コミットの順序を変更したり、コミットを完全に削除したりすることもできます。「Add cat-file」コミットを削除し、他の2つのコミットが導入される順序を変更する場合は、rebaseスクリプトを次のように変更できます。

次のようになります。

エディターを保存して終了すると、Gitはこれらのコミットの親までブランチを巻き戻し、310154eを適用してからf7f3f6dを適用し、停止します。これにより、これらのコミットの順序が効果的に変更され、「Add cat-file」コミットが完全に削除されます。

対話型rebaseツールを使用して、一連のコミットを単一のコミットにマージすることも可能です。スクリプトは、rebaseメッセージに役立つ指示を挿入します。

「pick」または「edit」ではなく「squash」を指定すると、Gitはその変更と直前の変更を適用し、コミットメッセージをマージします。したがって、これらの3つのコミットから単一のコミットを作成する場合は、スクリプトを次のようにします。

エディターを保存して終了すると、Gitは3つの変更をすべて適用し、3つのコミットメッセージをマージするためのエディターに戻ります。

保存すると、前の3つのコミットの変更を導入する単一のコミットが作成されます。

コミットの分割は、コミットを元に戻してから、作成したいコミットの数だけ部分的にステージングしてコミットします。たとえば、3つのコミットの中央のコミットを分割したいとします。「Update README formatting and add blame」の代わりに、「Update README formatting」を最初のコミットに、「Add blame」を2番目のコミットに分割したいとします。rebase -iスクリプトで、分割したいコミットの指示を「edit」に変更することで、これを行うことができます。

次に、スクリプトがコマンドラインに移動すると、そのコミットをリセットし、リセットされた変更を取り、それらから複数のコミットを作成します。エディターを保存して終了すると、Gitはリストの最初のコミットの親まで巻き戻し、最初のコミット（f7f3f6d）を適用し、2番目のコミット（310154e）を適用し、コンソールに移動します。そこで、git reset HEAD^を使用してそのコミットの混合リセットを実行できます。これにより、そのコミットが効果的に元に戻され、変更されたファイルはステージングされなくなります。これで、複数のコミットができるまでファイルのステージングとコミットを行い、作業が完了したらgit rebase --continueを実行できます。

Gitはスクリプトの最後のコミット（a5f4a0d）を適用し、履歴は次のようになります。

これにより、リストの最新の3つのコミットのSHA-1が変更されるため、変更されたコミットが、既に共有リポジトリにプッシュ済みのリストに表示されないようにしてください。リストの最後のコミット（f7f3f6d）は変更されていないことに注意してください。このコミットはスクリプトに表示されていますが、「pick」としてマークされ、rebaseの変更の前に適用されたため、Gitはコミットをそのままにします。

コミットを削除する場合は、rebase -iスクリプトを使用して削除できます。コミットのリストで、削除したいコミットの前に「drop」という単語を付けます（または、rebaseスクリプトからその行を削除します）。

Gitがコミットオブジェクトを構築する方法のため、コミットを削除または変更すると、それに続くすべてのコミットが書き換えられます。リポジトリの履歴を遡るほど、再作成が必要なコミットが増えます。削除したコミットに依存するシーケンスの後期に多くのコミットがある場合、多くのマージ競合が発生する可能性があります。

このようなrebaseを途中で中止し、良い考えではないと判断した場合は、いつでも停止できます。git rebase --abortと入力すると、リポジトリはrebaseを開始する前の状態に戻ります。

rebaseを終了して、望ましい結果ではないと判断した場合は、git reflogを使用して、ブランチの以前のバージョンを復元できます。reflogコマンドの詳細については、「データ復旧」を参照してください。

大量のコミットをスクリプト可能な方法で書き直す必要がある場合（たとえば、メールアドレスをグローバルに変更したり、すべてのコミットからファイルを除去したりする場合）に使用できる、別の履歴書き換えオプションがあります。コマンドはfilter-branchであり、履歴の大部分を書き直すことができます。そのため、プロジェクトがまだ公開されておらず、他の人が書き直そうとしているコミットに基づいて作業を行っていない限り、使用しない方が良いでしょう。ただし、非常に便利です。一般的な使用方法をいくつか学習することで、その機能の一部を理解することができます。