Rebase: 履歴の整理

コミット履歴を直線的に整理し、読みやすくする。

歴史の教科書の改訂 (Revising History Textbooks)

Rebaseは「歴史の教科書の改訂」です。過去の事実（コミット）を書き換えて、きれいなストーリー（直線的な履歴）にまとめます。出版済み（push済み）の教科書を書き換えると、すでに読んでいる学生（チームメンバー）が混乱します。 **ゴールデンルール**: 他の人がpullしたブランチはrebaseしない。

用語集

Rebase

コミットを別のベースに再適用。

Interactive

コミットを編集・整理しながらrebase。

Squash

複数コミットを1つに統合。

Force Push

リモート履歴を上書き（危険）。

基本Rebase（mainに追従）

feature ブランチを最新の main に追従させる。

Merge

1
# Merge creates a merge commit
2
# History looks like:
3
#
4
#   main ──●──●──────●──M──
5
#              \      /
6
#   feature     ●──●──●

Rebase

1
# Rebase creates linear history
2
# History looks like:
3
#
4
#   main ──●──●──●──●──●──●
5
#                    ↑
6
#          feature commits re-applied

1
# Sync feature branch with latest main
2
git switch feature/user-profile
3
git fetch origin
4
git rebase origin/main
5

6
# If conflicts occur:
7
# 1. Fix conflicts in your editor
8
# 2. Stage resolved files
9
git add resolved_file.ts
10
# 3. Continue rebase
11
git rebase --continue
12

13
# Or abort if things go wrong
14
git rebase --abort

実行結果

Successfully rebased and updated refs/heads/feature/user-profile.

Interactive Rebase（履歴編集）

コミットの編集、統合、削除ができる強力なツール。

1
# Edit last 3 commits
2
git rebase -i HEAD~3
3

4
# In the editor, you'll see:
5
pick abc1234 feat: Add user form
6
pick def5678 fix: Typo in validation
7
pick ghi9012 feat: Add email field
8

9
# Change 'pick' to:
10
# p, pick   = use commit as-is
11
# r, reword = use commit, but edit message
12
# e, edit   = use commit, but stop for amending
13
# s, squash = meld into previous commit (keep message)
14
# f, fixup  = meld into previous (discard message)
15
# d, drop   = remove commit entirely

Squash の例

1
# Before: Messy commits
2
pick abc1234 feat: Add user form
3
pick def5678 wip
4
pick ghi9012 fix typo
5
pick jkl3456 oops
6

7
# After: Clean squash
8
pick abc1234 feat: Add user form
9
squash def5678 wip
10
squash ghi9012 fix typo
11
squash jkl3456 oops
12

13
# Result: One clean commit with combined message

Tip: PR前に git rebase -i で「wip」「fix typo」などの雑なコミットを整理すると、レビューが楽になる。

Force Push（履歴の上書き）

警告: rebase後は通常のpushが拒否されます。force pushが必要ですが、他の人の作業を壊す可能性があります。

1
# After rebase, history has changed
2
# Regular push will be rejected
3

4
# Use --force-with-lease (safer than --force)
5
git push --force-with-lease origin feature/user-profile
6

7
# --force-with-lease checks if anyone else pushed
8
# before overwriting (prevents data loss)

ゴールデンルール: 自分だけが使っているブランチでのみ force push する。共有ブランチ (main, develop) では絶対にしない。

合格ライン

☐ git rebase で main に追従できる

☐ git rebase -i でコミットを整理できる

☐ squash と fixup の違いを説明できる

☐ force push のリスクを理解している

参考リンク

Pro Git - Rebasing

Atlassian Git Tutorial - Rebase

演習課題

課題1: 基本的なリベース

feature ブランチを main にリベースしてみてください。履歴が直線的になることを確認してください。

課題2: Interactive Rebase

git rebase -i HEAD~3 を使って、コミットを squash してみてください。