「履歴がスパゲッティ」から卒業しよう。Gitリベースで美しい歴史を刻むための処方箋
こんにちは。現場で長年Gitと格闘してきたエンジニアです。
チーム開発をしていると、ふとリポジトリの履歴を見て「誰だよ、こんなにマージコミットを乱立させたのは……」と頭を抱えたことはありませんか？ 履歴が枝分かれして複雑に絡み合う「スパゲッティ・ヒストリー」は、バグの根本原因（犯人）を突き止める作業を悪夢に変えてしまいます。
今回は、「直列で美しい履歴」を保ち、チームメンバーから「おっ、こいつのコミット履歴、読みやすいな」と一目置かれるための、`git pull –rebase` 完全攻略ガイドをお届けします。
—
1. なぜ「マージ」ではなく「リベース」なのか？
まずはメンタルモデルの共有です。
- git merge: 「あなたの変更」と「最新の変更」を混ぜ合わせるための、新しい「マージコミット」を生成します。履歴は分岐し、合流します。
- git rebase: 自分の変更を一旦脇に置き、最新の変更をベースにした上で、自分の変更を「その後に書き直して積み上げる」作業です。
つまり、リベースを使うと「まるで最初から最新のコードに対して自分が開発していたかのような、一直線の綺麗な履歴」を作ることができるのです。
直感的なイメージ
- Merge: `A -> B -> C` (メイン) と `A -> D` (自分) を無理やり合流させて `E` (マージコミット) を作る。
- Rebase: `A -> B -> C` と `A -> D` を、`A -> B -> C -> D’` (DをCの後に移植) に書き換える。
—
2. まずはここから！最強の初期設定
毎回 `–rebase` と打つのは面倒ですよね。実は、Gitには「pullする時は自動的にrebaseしてくれ」という魔法の設定があります。
ターミナルを開いて、以下のコマンドを実行してください。
pull時に自動的にrebaseを行う設定
git config –global pull.rebase true
リベース中にローカルの未コミット作業を自動で退避・復元する設定
git config –global rebase.autoStash true
- `pull.rebase true`: `git pull` と打つだけで、内部的にリベースが走るようになります。これで「マージコミットを消すためにリベースする」という手間が消滅します。
- `rebase.autoStash true`: これが伝説のハックです。リベースしようとした時、未コミットの変更があるとエラーで止まってしまいますよね。この設定があれば、Gitが勝手に作業を一時退避し、リベース完了後に勝手に戻してくれます。
—
3. コンフリクトが起きても慌てない「冷静な対処法」
「リベースしたらコンフリクトだらけで詰んだ！」と焦る必要はありません。リベース中のコンフリクトは、「自分のコードを一つずつ最新環境に適用している最中のチェックポイント」に過ぎません。
もしコンフリクトが発生したら、以下の手順をルーチン化してください。
1. ファイルを確認する：コンフリクトしたファイルを修正。
2. Gitに知らせる：
git add <修正したファイル名>
3. リベースを続行する：
git rebase –continue
もし途中で「もうリベースなんかやめたい！」と思ったら、迷わず以下を唱えてください。
git rebase –abort
これで、リベースを開始する前の安全な状態に100%戻れます。怖がることは何もありません。
—
4. 精度高い「HelloWorld」的動作確認（練習用フロー）
知識を定着させるために、一度だけこの練習をしてみてください。
1. 適当なディレクトリでリポジトリを作成
mkdir git-practice && cd git-practice
git init
echo “hello” > file.txt && git add . && git commit -m “initial commit”
2. 擬似的な並行作業を再現
# 別端末や別ディレクトリで同じファイルを変更し、先にpushされたと仮定する
# その間に自分のローカルで別コミットを作る
echo “work” >> file.txt && git commit -am “my work”
3. プルしてリベースを確認
git pull –rebase
これで、あなたの「my work」というコミットが、最新の履歴の「後ろ」に並んでいることが確認できれば成功です。`git log –oneline –graph` で確認すると、その一直線の美しさに感動するはずです。
—
最後に：なぜ「履歴」にこだわるのか
単なるこだわりではありません。履歴が綺麗なチームは、「いつ、誰が、なぜその変更をしたのか」を追跡するコストが圧倒的に低いのです。
美しい履歴は、未来の自分やチームメンバーへの最高のプレゼントになります。「リベースを使いこなす」ことは、単なるGitのテクニックではなく、チームの生産性を最大化するための規律なのです。
明日からの開発、ぜひ `–rebase` を標準装備にして、スマートなGitライフを送ってくださいね！応援しています。