【Git】revertとresetの違いと使い分け完全ガイド｜3層モデル・reset 5モード・reflog緊急復旧・revert-revert問題まで

+----------------------------------------+
| Working Tree (作業ツリー)              |  ← 実際のファイル
|   あなたがエディタで編集している内容    |
+----------------------------------------+
                 ↑↓ git add / git restore
+----------------------------------------+
| Index (ステージング/インデックス)       |  ← 次のコミット候補
|   git add で積み上げた変更             |
+----------------------------------------+
                 ↑↓ git commit
+----------------------------------------+
| HEAD (最新コミット)                    |  ← ブランチ先端
|   リポジトリに記録された最新状態        |
+----------------------------------------+

# 特定のコミットを打ち消す
git revert a1b2c3d

# 実行後
#   a1b2c3d の変更を反転する新コミットが作られる
#   エディタが開いてコミットメッセージを編集できる
#   → "Revert \"元のメッセージ\"" が自動入力

# エディタを開かず即時コミット
git revert a1b2c3d --no-edit

# コミットを作らず変更だけ適用（手動でcommit）
git revert --no-commit a1b2c3d

# revert中断
git revert --abort

# 複数コミットをまとめてrevert（レンジ指定）
git revert OLDER_SHA..NEWER_SHA
# → それぞれ別のrevertコミットが順に作られる

# レンジを1コミットにまとめてrevert
git revert --no-commit OLDER_SHA..NEWER_SHA
git commit -m "Revert feature X (multiple commits)"

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

# Cにバグがあったとする

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

# 履歴は一切削除されていない
# C' は「Cを取り消す」内容を持つ新しいコミット

# 状況：コミット済みだが、ファイル追加漏れがあった
git reset --soft HEAD~1
# HEADが1つ戻り、直前コミットの変更はすべてIndexに残る

# 追加ファイルを入れて再commit
git add forgotten_file.txt
git commit -m "feat: 新機能（ファイル追加漏れ修正込み）"

# 類似用途：複数コミットを1つにまとめたい
git reset --soft HEAD~3
git commit -m "feat: 機能Xをまとめて実装"

# 誤ってaddしたファイルをunstage
git reset HEAD secret.env
# ファイル自体は消えない（staging areaから外れるだけ）

# コミット自体をやり直したいが変更はそのまま
git reset HEAD~1
# HEADが戻り、変更がWorking Treeに残る

# ローカル作業を丸ごと捨てる
git reset --hard HEAD
# 未コミットの変更はすべて消える

# 過去の状態に完全に戻る
git reset --hard HEAD~3

# リモートと完全同期（ローカル変更全消し）
git fetch origin
git reset --hard origin/main

# 今いる位置に未コミット変更がある
# 移動先で同じファイルが変わっていたら失敗する（安全側）
git reset --keep main

# エラー例
# error: Entry 'foo.js' not uptodate. Cannot update.
#   → 衝突するファイルがあるので移動を拒否

# この挙動により --hard のような事故を防げる

# merge中にコンフリクトが出て「もう全部やめたい」
git reset --merge
# Working Treeの未コミット変更を保ちつつmergeを中止

# --abort との違い
# - git merge --abort : merge開始前の状態に戻る（標準）
# - git reset --merge : mergeを中断しつつ、未コミット変更は保護

# 特定ファイルだけHEADに戻す（--mixed相当）
git reset HEAD file.txt

# 特定ファイルだけ過去版に戻す
git reset a1b2c3 -- file.txt

# 注意：pathspec付きresetは --soft/--hard を受け付けない
# → --hard でファイル単位にしたいなら git checkout や git restore を使う
git restore --source=HEAD file.txt  # 推奨

Q1: 取り消したいコミットはpush済みですか？
   YES → revert 一択（reset禁止）
   NO  → Q2へ

Q2: 残したい要素は何ですか？
   コミットそのもの以外を残したい（変更・add状態） → reset --soft
   コミットだけ消し、変更はファイルに残したい     → reset --mixed（既定）
   すべて吹き飛ばしたい（完全に綺麗に）           → reset --hard（要stash確認）

Q3: 取り消したいのはファイル単位ですか？
   YES → git restore / git reset HEAD <file> を使う
   NO  → そのままresetまたはrevert

Q4: 取り消しを再確認・検証する必要がありますか？
   YES → revert --no-commit で変更だけ適用→テスト→commit
   NO  → そのままrevert／reset

# 一番簡単なのは amend（直前コミットそのものを編集）
git commit --amend -m "正しいメッセージ"

# 内容も変えたい場合
git add additional_file.txt
git commit --amend --no-edit

# 履歴を前のコミットに含めて再構築したい
git reset --soft HEAD~1
# 変更はIndexにまとめて残り、好きなようにcommit可能

# まだcommit前
git reset HEAD .env
# または
git restore --staged .env

# commit済みならまず履歴整形（pushしていない前提）
git reset --mixed HEAD~1
git restore --staged .env
echo ".env" >> .gitignore
git add .gitignore
git commit -m "Add .env to gitignore"

# push済みで.envが流出した場合は history rewrite が必要
# → git filter-repo か BFG Repo-Cleaner

# push済みmergeコミットを取り消す
git revert -m 1 <マージコミット>

# -m 1 = "一番目の親 (mainline)" を基準に差分を取る
# これをつけないとGitが「どっちの親を基準にすべきか分からない」とエラー
# fatal: commit <sha> is a merge but no -m option was given.

# ローカル変更を全部捨て、リモートと完全一致させる
git fetch origin
git reset --hard origin/main

# 対象ブランチを明示的に
git fetch origin feature
git reset --hard origin/feature

# 直後に未追跡ファイルも消してクリーンに
git clean -fd

# OLDER_SHAより新しくNEWER_SHAまでの全コミットをrevert
git revert OLDER_SHA..NEWER_SHA
# → コミットごとにrevertコミットが個別に作られる

# 1コミットにまとめたい場合
git revert --no-commit OLDER_SHA..NEWER_SHA
git commit -m "Revert feature X (rolled back 5 commits)"

# 逆順に適用されることに注意
# 順番次第でコンフリクトしやすいので --no-commit で最後にまとめるのが安全

# もとの流れ
# C (機能追加) → C' (C をrevert、機能削除)

# C' を revert すれば機能が戻る
git revert C'
# → C'' が作られ、再び機能が戻った状態になる

# 履歴
# ... → C → C' → C'' ...
#       +       ＋
#       機能     復活

# 誤って reset --hard してしまった直後
git reset --hard ORIG_HEAD
# → resetする前の位置に戻る

# ORIG_HEADの中身を確認
git rev-parse ORIG_HEAD
git log ORIG_HEAD -1 --oneline

# HEADの移動履歴を確認
git reflog
# a1b2c3d HEAD@{0}: reset: moving to HEAD~3
# f4e5d6c HEAD@{1}: commit: feat: 機能Y         ← これが欲しい
# 9a8b7c6 HEAD@{2}: commit: feat: 機能X

# HEAD@{1}に戻す
git reset --hard HEAD@{1}

# または直接ハッシュ指定
git reset --hard f4e5d6c

# もしすでにgc済みで消えていたら git fsck --lost-found で探す
git fsck --lost-found
ls .git/lost-found/commit/

# ファイル単位で過去版に戻す（Working Treeのみ）
git restore --source=HEAD~2 file.txt

# ファイル単位でIndexだけ戻す（unstage）
git restore --staged file.txt

# ファイル単位で両方戻す
git restore --source=HEAD --staged --worktree file.txt

# ハンク単位（行の一部）だけ取り消す
git restore -p file.txt
# → "y"/"n"/"s"でハンクごとに選択

# 直前のresetだけ取り消したい
git reset --hard ORIG_HEAD

# 数回前のresetを取り消したい
git reflog
git reset --hard HEAD@{5}

# 自分のローカルが上書きされた場合でも、
# 他メンバーがまだfetchしていなければ彼らのローカルにコミットが残っている

# 他メンバーから該当ブランチをforce pushしてもらう
# もしくはremote側のreflogを確認（GitHub APIでは参照できない）

# GitHubの場合
# - Events APIで過去のpushイベントを確認
# - Security Adminに連絡して削除前のSHAから復元依頼

# revertを取り消す
git revert <revertコミット>

# 複数のrevertを一気に取り消す
git revert OLDER_REVERT..NEWER_REVERT

## 取り消し操作のルール

### push済みブランチ
- 取り消しは **revert のみ**
- mainブランチでの `reset` / `push --force` は禁止（Branch protectionで物理強制）
- mergeコミットの取り消しは `revert -m 1` を必ず使用

### 未push ブランチ（個人作業）
- `reset --soft` / `reset --mixed` は自由に使用可
- `reset --hard` は直前に `git status` 確認＋必要なら `stash` 退避
- 共有featureブランチでは force-with-lease 必須（他メンバーに事前連絡）

### 事故対応
- `reset --hard` で消した場合、まず `git reflog` 確認→`ORIG_HEAD` か `HEAD@{N}` で復旧
- 90日以内なら `git fsck --lost-found` で孤児コミットも復旧可能
- 未コミット変更のロストは IDE の Local History を確認

### GitHub設定
- main/release 系は Branch protection で force push と削除を禁止
- Require pull request reviews：最低1名以上レビュー
- Require status checks：CIのgreen必須