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

最も最近のコミットを変更することは、おそらく最もよく行う履歴の書き換えでしょう。最後のコミットに対して、通常、次の2つの基本的なことを行いたいと思うでしょう。コミットメッセージを単純に変更するか、ファイルを追加、削除、変更することでコミットの実際の内容を変更するかです。

最後のコミットメッセージを単に修正したい場合、それは簡単です。

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

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

このテクニックを使用する際には注意が必要です。なぜなら、修正するとコミットのSHA-1が変更されるからです。これは非常に小さなリベースのようなものです。すでにプッシュした最後のコミットは修正しないでください。

履歴の中にある、より過去のコミットを修正するには、より複雑なツールに移行する必要があります。Gitには履歴修正ツールはありませんが、リベースツールを使用して、一連のコミットを元のベースとなっていたHEADにリベースすることができます。対話型リベースツールを使用すると、変更したい各コミットの後で停止し、メッセージを変更したり、ファイルを追加したり、好きなことをしたりできます。git rebaseに-iオプションを追加することで、対話的にリベースを実行できます。どのコミットまでさかのぼってコミットを書き換えたいかをコマンドに伝えることで、その範囲を指定する必要があります。

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

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

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

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

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

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

エディタを保存して終了すると、Gitはリスト内の最後のコミットに戻り、次のメッセージとともにコマンドラインに表示されます。

これらの指示は、何をすべきかを正確に教えてくれます。入力してください。

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

このコマンドは他の2つのコミットを自動的に適用し、これで完了です。pickをeditに複数の行で変更した場合、editに変更した各コミットに対してこれらの手順を繰り返すことができます。その都度、Gitは停止し、コミットを修正させ、完了したら続行します。

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

これを次のようにします。

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

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

「pick」または「edit」の代わりに「squash」を指定すると、Gitはその変更と直前の変更の両方を適用し、コミットメッセージを結合させます。したがって、これら3つのコミットから1つのコミットを作成したい場合、スクリプトを次のようにします。

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

これを保存すると、以前の3つのコミットのすべての変更を導入する単一のコミットが完成します。

コミットを分割すると、コミットが取り消され、その後、最終的に作成したいコミットの数だけ部分的にステージングおよびコミットが行われます。例えば、3つのコミットの真ん中のコミットを分割したいとします。「READMEのフォーマットを更新し、blameを追加」の代わりに、「READMEのフォーマットを更新」という最初のコミットと、「blameを追加」という2番目のコミットに分割したいとします。これは、rebase -iスクリプトで、分割したいコミットの指示を「edit」に変更することで行うことができます。

その後、スクリプトがコマンドラインに戻ったとき、そのコミットをリセットし、リセットされた変更を取り込み、それらから複数のコミットを作成します。エディタを保存して終了すると、Gitはリスト内の最初のコミット（f7f3f6d）の親に戻り、最初のコミット（f7f3f6d）を適用し、2番目のコミット（310154e）を適用し、コンソールに表示されます。そこで、git reset HEAD^でそのコミットをミックスリセットすると、そのコミットが実質的に取り消され、変更されたファイルはアンステージングされたままになります。これで、複数のコミットになるまでファイルをステージングしてコミットし、完了したらgit rebase --continueを実行します。

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

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

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

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

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

リベースを完了して、それが望むものではないと判断した場合、git reflogを使用してブランチの以前のバージョンを回復できます。reflogコマンドの詳細については、データ回復を参照してください。

もしスクリプト可能な方法で多数のコミットを書き換える必要がある場合（たとえば、メールアドレスを一括変更したり、すべてのコミットからファイルを削除したりする場合）に使えるもう1つの履歴書き換えオプションがあります。そのコマンドはfilter-branchで、履歴の広範囲を書き換えることができるため、プロジェクトがまだ公開されておらず、他の人が書き換えようとしているコミットに基づいて作業を行っていない限り、おそらく使うべきではありません。しかし、非常に役立つ場合もあります。その機能の一部を理解できるように、いくつかの一般的な使用法を学びます。