【Git】rebaseとmergeの違いと使い分け完全ガイド｜判断フローと5軸比較・PR統合3戦略・チーム運用ポリシーまで

# 現在の状況を確認（featureがmainから分岐）
git checkout main
git merge feature

# mainブランチにマージコミットが追加される
# featureブランチはそのまま残る

main     A---B---C---D
                  \
feature            E---F

main     A---B---C---D-------M
                  \         /
feature            E---F---/

# Mはparentが2つ（DとF）のマージコミット

# 個人ブランチの取り込み（ffで直線）
git merge feature

# PR統合を明示（必ずmerge commit）
git merge --no-ff feature -m "Merge PR #123: 新機能追加"

# pullで勝手にmergeされないよう保険
git pull --ff-only

# featureをmainの最新にrebase
git checkout feature
git rebase main

# featureのコミットが作り直され、mainの先端に積み上がる

main     A---B---C---D
                  \
feature            E---F

# featureはCから分岐したまま、
# mainのD（最新の改善）を知らない

main     A---B---C---D
                      \
feature                E'---F'

# E/FはE'/F'に作り直される（ハッシュが変わる）
# mergeコミットは作られない、履歴は一直線

# 開発者A（自分）: featureをrebaseしてforce push
git checkout feature
git rebase main
git push --force-with-lease origin feature

# 開発者B: 何も知らずにpullすると...
$ git pull origin feature
# → 大量のコンフリクト
# → Bのローカルの履歴が孤児化
# → Bの作業中コミットが消える可能性

git rebase -i main

# エディタで開かれるtodoリスト
pick a1b2c3 feat: 新機能追加
pick d4e5f6 fix: typo修正              # ← squashでまとめる
pick g7h8i9 feat: テスト追加           # ← rewordでメッセージ変更

# 編集後
pick   a1b2c3 feat: 新機能追加
squash d4e5f6 fix: typo修正            # a1b2c3に統合
reword g7h8i9 test: 単体テスト追加     # メッセージ変更

Q1: そのブランチはpushして他人も触っていますか？
   YES → merge（rebaseは絶対禁止）
   NO  → Q2へ

Q2: そのブランチはまだPR提出前の個人作業ですか？
   YES → rebase推奨（履歴を整えてPRへ）
   NO  → Q3へ

Q3: PRをmainへ統合するタイミングですか？
   YES → Q4へ
   NO  → pull時ならrebase、それ以外はmerge

Q4: PRの中間コミットを残したい？
   残したい   → Merge commit（--no-ff）
   1つにまとめたい → Squash and merge
   直線にしたい → Rebase and merge

main  A---B---C-----------M
                \       /
feature          D---E-/

# 中間コミットDとEがmainの履歴に残る
# PRの分岐構造が明示される

main  A---B---C---S

# Sは"feat: 新機能追加 (#123)"のような1コミット
# featureブランチの中間コミットは履歴に残らない

main  A---B---C---D---E

# 中間コミット(D, E)は残るが、mainは一直線のまま
# マージコミットは作られない

# 個人開発の基本設定
git config --global pull.rebase true
git config --global pull.ff only  # rebase失敗時の保険

# rebase中の自動stash
git config --global rebase.autoStash true

# autosquashも有効化（fixup/squashコミット自動処理）
git config --global rebase.autoSquash true

# NG：他人の変更を上書きする可能性
git push --force origin feature

# OK：リモートが想定どおりの場合のみ通る
git push --force-with-lease origin feature

# さらに安全：リモート参照の確認付き
git push --force-with-lease=feature:$(git rev-parse origin/feature) origin feature

## ブランチ戦略
- main: 常にデプロイ可能、force push禁止
- feature/*: 個人作業、自由にrebase可
- release/*: リリース前固定、mergeのみ

## pull
- `pull.rebase = true` を全員設定
- `pull.ff = only` で事故防止

## PR統合
- 小〜中PR → Squash and merge（デフォルト）
- リリースPR → Create a merge commit（--no-ff）
- ホットフィックス → Squash and merge

## rebase
- PR提出前の履歴整形は推奨（interactive rebase）
- pushされた共有ブランチのrebaseは禁止
- 必要な場合は必ずチーム合意＋--force-with-lease

## コミットメッセージ
- Conventional Commits準拠
- Squash時はPRタイトルをそのまま使用

## PR統合
- PR統合はRebase and merge一択
- mainは常に一直線（merge commit禁止）

## コミット単位
- 1コミット=1論理変更を徹底
- 雑なWIPコミットはPR提出前にinteractive rebaseで整理

## レビュー
- コミット単位でレビュー可能
- bisect前提の履歴品質を維持