【Git】rebase中のエラー完全復旧ガイド｜7パターン診断＋safety branchで二度と詰まらない

$ git rebase main
Auto-merging src/app.js
CONFLICT (content): Merge conflict in src/app.js
error: could not apply a1b2c3d... feat: 新機能
hint: Resolve all conflicts manually, mark them as resolved with
hint: "git add/rm <conflicted_files>", then run "git rebase --continue".

# 他にもこんなエラー
# "fatal: It seems that there is already a rebase-merge directory"
# "error: cannot rebase: Your index contains uncommitted changes"
# "CONFLICT (modify/delete)"
# "The previous cherry-pick is now empty, possibly due to conflict resolution"

# ■ STEP 1：状況把握（20秒）
git status
# "You are currently rebasing branch X on Y" が出る

# ■ STEP 2：選択肢は3つだけ（40秒）
# A) 解消して進める
git add .
git rebase --continue

# B) この1コミットだけ飛ばす
git rebase --skip

# C) 開始前に完全に戻す（安全）
git rebase --abort

# ■ STEP 3：--abort で戻ったらsafety branchを切る（推奨）
git switch -c safety/before-rebase-$(date +%H%M)
git switch -   # 元ブランチに戻って再挑戦

# 基本状態
git status

# .git内の進行ファイル確認
ls .git/rebase-merge 2>/dev/null && echo "interactive or merge rebase中"
ls .git/rebase-apply 2>/dev/null && echo "apply rebase中"

# 現在処理中のコミット
cat .git/rebase-merge/stopped-sha 2>/dev/null
cat .git/rebase-merge/message 2>/dev/null

# 進捗（interactive rebaseの場合）
cat .git/rebase-merge/done
cat .git/rebase-merge/git-rebase-todo
# done=処理済み、todo=残りの計画

# HEADの移動履歴（reflog）
git reflog --date=iso | head -20

# 1. 衝突しているファイルを確認
git status
# both modified: src/app.js

# 2. エディタで該当ファイルを開いて手動解消
# <<<<<<< HEAD
# 現在の変更
# =======
# rebase先の変更
# >>>>>>> a1b2c3d...

# 3. 解消したファイルをステージ
git add src/app.js

# 4. 続行
git rebase --continue
# → エディタが開いてcommitメッセージ確認。そのまま保存してOK

# または：このコミットが不要ならスキップ
git rebase --skip

# または：やめて最初に戻る
git rebase --abort

# rebase中の ours=rebase先（新しいbase）、theirs=移動中のコミット
# 通常のmergeと逆！

# rebase先の内容を採用
git checkout --ours path/to/file

# 移動中コミットの変更を採用
git checkout --theirs path/to/file

git add path/to/file
git rebase --continue

$ git rebase main
error: cannot rebase: You have unstaged changes.
error: Please commit or stash them.

# 未コミット変更を退避（未追跡も含む -u）
git stash push -u -m "before rebase"

# rebase実行
git rebase main

# 完了後に変更を戻す
git stash pop

# もしくは一時コミットして後でsquashする
git add .
git commit -m "WIP: rebase前の退避"
git rebase main
# rebase中にこのcommitをsquashでまとめる

# rebase時に自動でstash＆pop
git config --global rebase.autoStash true

# これで未コミット変更があっても自動退避＆復元
git rebase main

$ git rebase main
fatal: It seems that there is already a rebase-merge directory,
and I wonder if you are in the middle of another rebase.
If that is the case, please try
    git rebase (--continue | --abort | --skip)

# まずは状態確認
git status

# 進められる状態なら続行
git rebase --continue

# 進められないなら中止
git rebase --abort

# --abortも失敗して壊れていると判断した場合の最終手段
# (非推奨：データ喪失リスクあり)
rm -rf .git/rebase-merge .git/rebase-apply
git reset --hard ORIG_HEAD   # reflog確認してから

$ git rebase main
error: The following untracked working tree files would be overwritten by checkout:
    config/local.env
Please move or remove them before you merge.

# untrackedファイルを含めてstash退避
git stash push -u -m "untracked before rebase"
git rebase --continue   # 中断していたrebaseなら
# または
git rebase main   # 新規開始

git stash pop

# そのファイルが不要ならバックアップしてから削除
mv config/local.env config/local.env.bak
git rebase main

$ git rebase -i HEAD~5
error: unknown command: "fxp"
You can fix this with 'git rebase --edit-todo' and then run 'git rebase --continue'.
# タイポで "fxp" と書いてしまった → 正しくは "fixup"

# todoを再編集
git rebase --edit-todo
# エディタが開くので誤行を修正して保存

# 続行
git rebase --continue

# 有効なコマンド（省略形も可）
# p, pick   コミットを使用
# r, reword メッセージを編集
# e, edit   コミットで停止して修正
# s, squash 前のコミットに統合（メッセージ統合）
# f, fixup  前のコミットに統合（メッセージ破棄）
# d, drop   コミットを削除
# x, exec   シェルコマンド実行
# l, label  ラベル付与（--rebase-merges時）
# t, reset  リセット（--rebase-merges時）
# m, merge  マージ（--rebase-merges時）

# 省略形を既定化
git config --global rebase.abbreviateCommands true

$ git rebase --continue
The previous cherry-pick is now empty, possibly due to conflict resolution.
If you wish to commit it anyway, use:
    git commit --allow-empty

If you wish to skip this commit, use:
    git rebase --skip

# 内容が空になったコミットを捨てる
git rebase --skip

# 意図的に空コミットを残したい場合
git commit --allow-empty
git rebase --continue

# pre-commit hookがlint失敗で止まった場合
# 手動でlintを修正
git add .
git rebase --continue

# hookを一時的に無効化してrebase継続
git rebase --continue --no-verify   # Git 2.36+のみ
# 古いGitなら環境変数で回避
GIT_COMMITTER_NAME="X" git -c core.hooksPath=/dev/null rebase --continue

# rebase中にGPG/SSH署名が失敗するケース
# 一時的に署名を無効化
git -c commit.gpgsign=false rebase --continue

# GPG agent再起動
gpgconf --kill gpg-agent
gpgconf --launch gpg-agent
git rebase --continue

# 署名済みコミットを保つ必要がなければ恒久設定
git config commit.gpgsign false

$ git rebase --continue
fatal: Unable to create '.git/index.lock': File exists.

# 他のgitプロセスが実行中でないことを確認
ps aux | grep git

# 残留ロックを削除（他プロセスがいないときのみ）
rm -f .git/index.lock
git rebase --continue

# rebase前に退避ブランチを切る
git switch -c safety/before-rebase-$(date +%Y%m%d-%H%M) HEAD

# 元ブランチに戻ってrebase
git switch -
git rebase main

# 失敗したら一発で復元
git reset --hard safety/before-rebase-20260421-1030

# うまくいったらsafety branchは削除
git branch -D safety/before-rebase-20260421-1030

# git safe-rebase コマンドを定義
git config --global alias.safe-rebase '!f() { \
  local safety="safety/$(git branch --show-current)-$(date +%Y%m%d-%H%M%S)"; \
  git branch "$safety" && \
  echo "Safety branch created: $safety" && \
  git rebase "$@"; \
}; f'

# 使い方
git safe-rebase main

# reflogでrebase開始前を探す
git reflog --date=iso
# 出力例:
# abc1234 HEAD@{0}: rebase finished: returning to refs/heads/feature
# def5678 HEAD@{1}: rebase onto main
# ghi9012 HEAD@{2}: rebase (start): checkout main
# jkl3456 HEAD@{3}: commit: ... ← rebase開始前

# rebase開始直前のハッシュに戻す
git reset --hard jkl3456
# または
git reset --hard HEAD@{3}

# ブランチとして復元
git branch -f feature jkl3456

# 過去の位置から特定ファイル復元
git checkout HEAD@{3} -- path/to/file
git add path/to/file
git commit -m "restore: rebase中に失ったファイルを復元"

# rebase時に未コミット変更を自動stash
git config --global rebase.autoStash true

# "fixup!" や "squash!" プレフィックスのコミットを自動整理
git config --global rebase.autoSquash true

# interactive rebaseで短縮コマンド（p/r/e/s/f/d）を既定化
git config --global rebase.abbreviateCommands true

# pullでrebase既定
git config --global pull.rebase true

# rebase実行時に更新された追跡ブランチを教えてくれる
git config --global rebase.updateRefs true

# rerere（同じconflictを記憶）
git config --global rerere.enabled true

# Git 2.26+でempty commit自動drop
git config --global rebase.empty drop

# 修正したいコミットをマークしながらfixup commit作成
git commit --fixup <修正対象SHA>
# → "fixup! 元commitメッセージ" というcommitが作られる

# rebase時に自動統合
git rebase -i --autosquash <修正対象の親SHA>
# autosquashでfixup対象に自動並び替えされる

# autosquash をデフォルト化しておけば --autosquash 不要
git config --global rebase.autoSquash true
git rebase -i <base>

git rebase --rebase-merges -i main
# エディタに以下のような複雑なtodoが表示される:
#
# label onto
#
# # Branch: feature/a
# reset onto
# pick 1a2b3c4 feat: Aの実装
# pick 5d6e7f8 feat: Aの続き
# label A
#
# # Branch: feature/b
# reset onto
# pick 9g0h1i2 feat: Bの実装
# label B
#
# reset onto
# merge -C <元merge> A # merge feature/a into main
# merge -C <元merge> B # merge feature/b into main

git status
# both modified: ...
# エディタで解消
git add .
git rebase --continue

git rebase --abort
git status   # rebase前に戻った

git rebase --skip
# 次のcommitから再開

# abort が効かない場合
git reflog
# rebase (start) のSHAを特定
git reset --hard HEAD@{N}
rm -rf .git/rebase-merge .git/rebase-apply