HN 日本語サマリー

← 一覧へ戻る
プログラミング

Git rebase -I はそれほど怖くない

Git rebase -I is not that scary (cachebag.sh)

100 pointsby vinhnx122 コメント

要約

Junior devが恐れがちな`git rebase -i`コマンドについて、その仕組みと安全性を解説する記事です。テキストエディタでコミットの並べ替えや編集、削除を行うインタラクティブな操作であり、`git rebase --abort`や`git reflog`、ブランチのバックアップといった安全策があるため、恐れる必要はないと述べています。

全文翻訳

git rebase -i はそれほど恐れるものではない

ジュニアデベロッパーとしてのキャリア初期に私が遭遇した最も衝撃的なことの一つは、git rebase -i を取り巻く恐怖です。

私の同僚の中にも、多くの点で私よりもはるかに賢い人々がいますが、多くの開発者にとってこのコマンドを恐れるのはパターンになっているようです。

実際には何をするのか

以下を実行すると:

git rebase -i HEAD~4

Git は実に平凡なことをします。テキストファイルを開くのです。もしあなたがターミナルから作業していて、Git の設定をいじったことがないなら、git config --global core.editor "_YOUR-EDITOR_" は Vim を征服することへの恐怖を和らげる良い方法です。

pick a1b2c3d Add user model
pick e4f5g6h Fix typo in user model
pick i7j8k9l Add login endpoint
pick m0n1o2p WIP debugging login

# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash" but discard this commit's message
# d, drop <commit> = remove commit

新しいリベースを行う人がここで注目すべきは、これは 計画 であり、アクションではないということです。リベースが開始されたという事実を除けば、技術的にはまだ何も起こっていません。気が変わった場合は、単に git rebase --abort を実行し、再開するか諦める(理想的には前者)だけです。

各行は命令であり、ターゲットにしたコミットの再プレイが開始されます。これらの命令を好きなように組み合わせることができます。

r a1b2c3d Add user model
pick e4f5g6h Fix typo in user model
pick i7j8k9l Add login endpoint
d m0n1o2p WIP debugging login

# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash" but discard this commit's message
# d, drop <commit> = remove commit

ここで何が起こったか:

  1. この例では、Git は最初のコミットで「一時停止」し、メッセージを書き換えることができます。
  2. d または drop は、WIP デバッグコミットを完全に削除します。この同じ結果は、単に行を削除することでも達成できます。

中央の 2 つのコミットは、周囲のコミットを変更したにもかかわらず、変更されませんでした。最終結果は、4 つではなく合計 3 つのコミットになります。

正直なところ、それだけです。大したことではありません。その例が何をするかを理解できれば、インタラクティブなリベースは、あなたの人生をより困難にするのではなく、より簡単にすることになるツールになります。

インタラクティブなリベースの目的を損なうことを好む人々の間にも、一般的なことがあります。それらの議論に立ち入らずに、私は率直に言います:私の意見では、クリーンなブランチ履歴を気にしないのであれば(リベースが提供する改善のごく一部)、ソフトウェアに対してどれほど真剣であるかについて、私は懐疑的になる傾向があります。

「でも、もし私がそれを台無しにしたら?」

ここでは実際に作業を失うことは非常に困難です。その理由は 3 つあります。

いつでも中止できます。 前述のように git rebase --abort で。

あなたのブランチは、開始前とまったく同じ状態に戻ります。

リベースはコミットを破壊せず、新しいコミットを作成します。 これが重要なメンタルモデルです。リベースは古いコミットを編集しません。新しいコミットを作成し、ブランチポインタをそれらに移動させるだけです。古いコミットは Git のオブジェクトデータベース内に存在し、ガベージコレクションが来るまでの間、参照されませんがそのまま残ります。

reflog はすべてを記憶しています。 これは、私が最初のインターンシップで、同僚が以前に行ったコミットを削除したいと思っていたと勘違いして、彼のブランチの履歴を消してしまったときに、特に理解することが重要でした。Git はあなたのブランチがどこを指していたかのジャーナルを保持しています:

git reflog

リベース前のエントリを見つけて復元します:

git reset --hard HEAD@{4}

リベース全体が元に戻されます。このセーフティネットは常に存在するため、失敗したリベースの最悪の現実的な結果は、reflog を数分間調べることです。

そして、reflog でさえ daunting に感じる場合(ただし、私の投稿をここまで読んだのであれば、それを処理するのに十分な能力があることを期待しますが)、もちろん、低レベルの保険ポリシーがあります:

git branch backup-before-rebase

これで、リベース前の状態に名前が付きました。何か問題が発生した場合は、git reset --hard backup-before-rebase で安全に戻ることができます。

コンフリクト

リプレイされたコミットが以前の変更とコンフリクトすることがあります(通常は並べ替え時、または更新されたメインブランチにリベースする時)。Git は停止し、文字通り指示を表示します:マージコンフリクトと同じようにコンフリクトを解決し、ファイルを git add してから git rebase --continue を実行します。

これが人々を最も悩ませる点だと思います。しかし、コンフリクトは Git にとって新しい概念ではありません。実際、インタラクティブなリベースの文脈では、コンフリクトはマージよりも解決しやすいとさえ言えます。なぜなら、一度に 1 つのコミットのみを扱い、ブランチ全体ではないからです。

義務的な警告

ソフトウェアのあらゆるものと同様に、特にリベースのような破壊的なものに関しては、何をしているのかを理解するために多大な注意と努力を払うべきです。はい、作業は回復できますが、それはあなたがずさんであることの言い訳にはなりません。

私が従う良い一般的な経験則は、レビューの前または最中に、自分のフィーチャーブランチを自由にリベースできるようにすることです。結果を git push --force-with-lease で自分のリモートブランチにプッシュするのは普通で問題ありません(--force-with-lease は、誰かがその間にプッシュした場合にプッシュを拒否します。常に通常の --force よりもこちらを優先してください)。

まとめ

個人的には、価値のある開発者であれば、少なくとも非常に簡単なインタラクティブなリベースを実行できるべきだと考えています。この記事は、いつ、なぜそれを使用すべきか(ただし、私はそれを惜しみなく使用すべきだと信じていますが)についてはあまり触れていません。主にプロセスを分かりやすくし、試してみることを奨励するためのものです。特にジュニア/初心者デベロッパーの場合。