Gitで変更を取り消す方法 — reset・revert・reflogの違いと使い分け

Gitで変更を取り消す。コミットを表す点と取り消しの矢印、履歴のノート。

git reset --hard を打って、画面が一瞬で静かになったときのことを覚えています。2時間ぶんの作業が消えました。 正確には、消えたと思いました。

Git を使っていて一番怖いのは、やり直し方を知らないまま操作することです。知らないと、コミットするのが怖くなり、ブランチを切るのが怖くなり、最後には「触らないほうが安全」になります。それが一番危ない状態です。

この記事は、「やってしまった」を種類ごとに分けて、全部わざと起こして、全部戻す回です。読むだけでは身に付かないので、壊してよい練習用のリポジトリを作って、実際に踏みます。

対象レベル: PC入門 / 区分: 必修

目次

この記事でわかること

  • Git には3つの置き場所があり、取り消しコマンドは「どこを戻すか」で選ぶこと
  • reset の --soft / --mixed / --hard が、それぞれ何を戻して何を残すか
  • 消したコミットは、しばらく残っていること(そして、残らないものは何か)
  • push したあとは revert、push 前なら reset という使い分けの理由
  • 作業を中断したいときの stash と、その stash を消してしまったときの戻し方

この記事でやること

  1. 壊してよい練習用リポジトリを作る
  2. 3つの置き場所を、コマンドの出力で見る
  3. reset の3つを、同じ状態から3回試して違いを見る
  4. reset --hard で消したコミットを、reflog で取り戻す
  5. push 済みの間違いを revert で戻す
  6. stash を消してしまい、それも取り戻す

先に知る言葉

この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。

言葉意味
作業ツリーいまエディタで開いているファイルそのもの。フォルダの中身
ステージ(index)git add したものが入る、コミット直前の控え室
HEAD「いま自分がどのコミットの上にいるか」を指す矢印
HEAD~1HEAD の1つ前のコミット。~2 なら2つ前
reflogHEAD が動いた履歴。コミット履歴とは別物で、手元にしか無い
到達できないコミットどのブランチからも辿れなくなったコミット。消えたように見えるが、しばらく残る

準備 — 壊してよいリポジトリを作る

本物のリポジトリで練習しないでください。 この記事は、わざと壊す手順を含みます。

cd ~
mkdir undo-lab
cd undo-lab
git init
git config user.name  "practice"
git config user.email "practice@example.com"

コミットを3つ作ります。

echo "1行目" > memo.txt
git add memo.txt
git commit -m "1つ目"

echo "2行目" >> memo.txt
git commit -am "2つ目"

echo "3行目" >> memo.txt
git commit -am "3つ目"

git log --oneline
c3c3c3c 3つ目
b2b2b2b 2つ目
a1a1a1a 1つ目

コミットIDは自分の環境では違う値になります。 以降の a1a1a1a などは、自分の git log --oneline に出た値に読み替えてください。

① 3つの置き場所を、目で見る

取り消しのコマンドが多く見えるのは、戻す場所が3つあるからです。逆に言えば、「どこを戻したいのか」が決まれば、コマンドは1つに決まります。

作業ツリー          ステージ            HEAD
(編集中のファイル)  (add したもの)      (コミット済み)

     │  git add  →   │  git commit  →   │
     │               │                  │
     ← git restore ─ ← git restore ──── │
                       --staged

実際に、3つが食い違う状態を作ります。

echo "ステージに入れる変更" >> memo.txt
git add memo.txt
echo "まだ入れていない変更" >> memo.txt
git status --short
MM memo.txt

MM の2文字が、そのまま2つの場所を表しています。 左が「ステージと HEAD の差」、右が「作業ツリーとステージの差」です。両方に変更がある状態です。

この2文字は、慣れると git status の長い日本語より速く読めます。 よく出るものだけ並べておきます。

表示状態
M (左だけ)add 済みで、そのあと触っていない
 M(右だけ)直しただけで、まだ add していない
MMadd したあとに、また直した
A 新しく add した(HEAD にはまだ無い)
??Git が知らないファイル(一度も add されていない)

?? だけは特別です。 Git が一度も記録していないので、restore の対象にもならず、reset --hard でも消えません。逆に、git clean -fd を打つとまとめて消えます。こちらは reflog にも fsck にも残らないので、clean は -n(何が消えるか見るだけ)を先に打つ癖を付けてください。

git clean -nd      # 消える予定のものを並べるだけ
git clean -fd      # 実際に消す(戻せません)
git diff              # 作業ツリー ↔ ステージ(まだ add していない分)
git diff --staged     # ステージ ↔ HEAD(add 済みで、まだコミットしていない分)

② 取り消しの一覧表

この表が、この記事の目次です。 迷ったらここに戻ってきてください。

戻したいものコマンド危険度
編集を捨てる(add 前)git restore <file>高(戻せない)
add を取り消す(編集は残す)git restore --staged <file>低
直前のコミットをやり直すgit commit --amend中(push 後は高)
コミットだけ取り消す(変更は残す)git reset --soft HEAD~1低
コミットと add を取り消すgit reset HEAD~1低
コミットも編集も全部捨てるgit reset --hard HEAD~1最高
push 済みのコミットを打ち消すgit revert <id>低
作業を一時的にどけておくgit stash低
消したコミットを探すgit reflog—(読むだけ)

危険度は「戻せるか」で付けています。 コミットしてあるものは、たいてい戻せます。コミットしていないものだけが、本当に消えます。 これがこの記事で一番大事な1行です。

③ まだコミットしていない変更を捨てる

さきほど作った、食い違った状態から始めます。

add を取り消す(編集は残る)

git restore --staged memo.txt
git status --short
 M memo.txt

左の M が消えました。 ステージから降りただけで、ファイルの中身は変わっていません。

編集そのものを捨てる(戻せません)

git restore memo.txt
git status --short
cat memo.txt
1行目
2行目
3行目

足した2行が消えました。そして、これは戻せません。 reflog にも残りません。reflog はコミットの履歴であって、コミットしていないものは記録されていないからです。

昔の記事では git checkout -- ファイル と書かれています。 同じことをします。checkout が「ブランチの切り替え」と「ファイルの復元」というまったく違う2つの仕事を兼ねていて紛らわしかったため、Git 2.23 で switch(切り替え)と restore(復元)に分かれました。新しく覚えるなら分かれたほうです。

④ 直前のコミットをやり直す

メッセージを間違えた、ファイルを1つ入れ忘れた——という場面です。

echo "4行目" >> memo.txt
git commit -am "3つめ"          # わざとメッセージを間違える
git commit --amend -m "4つ目"
git log --oneline -1
d4d4d4d 4つ目

コミットIDが変わっていることに注目してください。 --amend は「直前のコミットを編集する」ように見えますが、実際は新しいコミットを作って、古いほうを捨てているだけです。Git のコミットは中身から ID を作るので、1文字でも変えれば別物になります。

push したあとに --amend しないでください。 手元とリモートで別のコミットになるため、push が拒否され、通すには --force が要ります。他人がその枝を取っていたら、その人の履歴と食い違います。どうしても必要なときは --force-with-lease を使ってください。自分が見ていない間に誰かが push していたら、押し戻さずに止まってくれます。

⑤ reset の3つを、同じ状態から試す

reset が分かりにくいのは、3つのオプションが「3つの置き場所のうち、どこまで戻すか」を表しているからです。 表で覚えるより、同じ場所から3回やるほうが早いです。

オプションHEADステージ作業ツリー
--soft戻すそのままそのまま
--mixed(既定)戻す戻すそのまま
--hard戻す戻す戻す

soft — コミットだけ取り消す

git reset --soft HEAD~1
git log --oneline -1
git status --short
c3c3c3c 3つ目
M  memo.txt

コミットは1つ減り、変更は「add 済み」の状態で残っています。 「コミットを分けたい」「メッセージを書き直したい」ときに使います。

実際に一番よく使うのは、細かく切りすぎたコミットを1つにまとめ直す場面です。git reset --soft HEAD~3 と打つと、直近3つのコミットが消えて、その変更が全部ステージに乗った状態になります。そのまま git commit すれば、1つのコミットとして作り直せます。rebase を覚える前に、これだけで大半は足ります。

mixed — コミットと add を取り消す

git commit -m "4つ目"          # いったん戻す
git reset HEAD~1               # --mixed が既定
git status --short
 M memo.txt

左の M が無くなりました。 変更はファイルに残っていますが、add からは降りています。

hard — 全部捨てる

git commit -am "4つ目"
git log --oneline
d4d4d4d 4つ目
c3c3c3c 3つ目
b2b2b2b 2つ目
a1a1a1a 1つ目

ここで、覚悟して打ちます。

git reset --hard HEAD~2
git log --oneline
cat memo.txt
b2b2b2b 2つ目
a1a1a1a 1つ目

1行目
2行目

コミット2つと、ファイルの2行が消えました。 これが冒頭の状態です。

⑥ 消えたコミットを reflog で取り戻す

git log には、もう「3つ目」も「4つ目」も出てきません。ですが、消えてはいません。

なぜ残っているのか。 Git のコミットは、枝の名前から数珠つなぎに辿れる形で置かれています。reset がやったのは、枝の矢印を古いほうへ動かしただけで、コミットそのものを消しに行ってはいません。辿る道が無くなっただけで、物としては .git の中に残っています。

【reset --hard の前】
  a1 ─ b2 ─ c3 ─ d4   ← main

【reset --hard HEAD~2 の後】
  a1 ─ b2             ← main
         ╲
          c3 ─ d4     ← どの枝からも辿れない(でも、まだある)

その「辿れなくなったコミット」への入口が reflog です。

git reflog
b2b2b2b HEAD@{0}: reset: moving to HEAD~2
d4d4d4d HEAD@{1}: commit: 4つ目
c3c3c3c HEAD@{2}: reset: moving to HEAD~1
d4d4d4d HEAD@{3}: commit: 4つ目
c3c3c3c HEAD@{4}: reset: moving to HEAD~1
d4d4d4d HEAD@{5}: commit (amend): 4つ目
c3c3c3c HEAD@{6}: commit: 3つ目

これは「コミットの履歴」ではなく「HEAD が動いた記録」です。 打ち消した操作も、やり直した操作も、全部そのまま並んでいます。手元にしか無く、push もされません。

戻します。

git reset --hard d4d4d4d
git log --oneline
cat memo.txt
d4d4d4d 4つ目
c3c3c3c 3つ目
b2b2b2b 2つ目
a1a1a1a 1つ目

1行目
2行目
3行目
4行目

戻りました。 コミットIDを直接指定する代わりに、git reset --hard HEAD@{1} のように reflog の番号でも指定できます。

ここが、この記事で一番覚えてほしいところです。 コミットしてあれば、たいてい戻せます。 だから、迷ったらまずコミットしてください。「きれいな履歴にしてから」と考えて手元に貯めるほうが、よほど危険です。履歴は rebase であとから整えられますが、存在しないコミットは整えられません。

本当に消えるもの

状態戻せるか
コミット済み(どの枝からも辿れない)戻せる(reflog にある)
add 済み・コミット前戻せることがある(git fsck で拾える)
編集しただけ・add 前戻せない

reflog も永久ではありません。既定では、辿れるものは90日、辿れないものは30日で期限切れになり、その後の git gc で本当に消えます。

git config --get gc.reflogExpire            # 既定 90 days(未設定なら何も出ない)
git config --get gc.reflogExpireUnreachable # 既定 30 days

⑦ push したものは revert で戻す

reset は履歴を書き換えます。 手元だけならそれで構いませんが、push 済みのものを書き換えると、他人の手元と食い違います。

push したあとは、履歴を消さずに「打ち消すコミットを足す」——それが revert です。

git revert --no-edit d4d4d4d
git log --oneline
cat memo.txt
e5e5e5e Revert "4つ目"
d4d4d4d 4つ目
c3c3c3c 3つ目
b2b2b2b 2つ目
a1a1a1a 1つ目

1行目
2行目
3行目

「4つ目」は履歴に残ったまま、その変更だけが取り消されています。 何が起きたかが履歴に残るので、あとから読む人が困りません。

「間違いを消したい」と「間違いを取り消したい」は、別のことです。 共有したあとに消しにいくと、他人が持っている履歴と食い違い、その人の手元で「知らないコミットが増えた/減った」が起きます。起きたことは残し、打ち消した事実も残す——これが、複数人で作業するときに履歴を信用できる理由です。一人で開発していても、半年後の自分は他人なので、同じ理屈が効きます。

resetrevert
履歴書き換える(消える)足す(残る)
共有した後使わない使う
1つだけ戻すやりにくい得意

マージコミットを revert するときだけ、追加の指定が要ります。 どちらの親を「元」とみなすかが決まらないためで、git revert -m 1 <id> のように -m で番号を渡します。ふつうは 1(取り込んだ側の枝)です。

⑧ 作業を一時的にどける — stash

「別の枝の不具合を先に直してほしい」と言われた、けれど手元は中途半端——という場面です。

echo "書きかけ" >> memo.txt
git stash push -m "書きかけの作業"
git status --short
cat memo.txt
1行目
2行目
3行目

作業ツリーがきれいになりました。 どけた中身は残っています。

git stash list
git stash show -p stash@{0}

戻すときは2通りあります。

コマンド意味
git stash pop戻して、控えを消す
git stash apply戻して、控えを残す(不安なときはこちら)
git stash pop
cat memo.txt

消してしまった stash を取り戻す

ここも、実は戻せます。 わざと消してみます。

echo "消える予定の作業" >> memo.txt
git stash push -m "うっかり消す"
git stash drop
git stash list
(何も出ない)

stash もコミットとして保存されているので、辿れなくなっただけです。

git fsck --unreachable | grep commit
unreachable commit f6f6f6f...
git show f6f6f6f              # 中身を確かめてから
git stash apply f6f6f6f

戻りました。 「コミットしてあれば戻せる」が、ここでも効いています。

⑨ 他の枝の1コミットだけ欲しい — cherry-pick

枝をまるごとマージするのではなく、1つのコミットだけ持ってきたいときに使います。

git switch -c fix
echo "小さな修正" >> memo.txt
git commit -am "小さな修正"
git log --oneline -1
g7g7g7g 小さな修正
git switch -
git cherry-pick g7g7g7g
git log --oneline -2

コミットIDは変わります。 中身は同じでも、乗っている親が違うためです。同じ変更が2つの枝にある状態になるので、あとでマージすると衝突することがあります。多用しないでください。

完成の判定

次の5つを、自分の手で1回ずつ起こして戻せたら合格です。 読んだだけでは、いざというときに手が動きません。

#わざと起こすこと戻し方
1間違えて git add したgit restore --staged
2コミットのメッセージを間違えたgit commit --amend
3reset --hard でコミットを2つ飛ばしたgit reflog → git reset --hard <id>
4push 済みのコミットが間違っていたgit revert
5git stash drop で作業を消したgit fsck --unreachable → git stash apply

つまずいたところ

reflog に何も出てこない

clone した直後のリポジトリや、まだ HEAD を動かしていないリポジトリでは、reflog はほとんど空です。reflog は「自分の手元での操作」の記録なので、他人の操作や clone 前の履歴は入っていません。

reset --hard したら、編集中のファイルまで消えた

仕様どおりです。--hard は作業ツリーまで戻します。そして、コミットしていなかった編集は reflog にも残りません。 打つ前に git status を見る習慣が、唯一の防御です。

git status --short     # 何か出ていたら、--hard の前に stash する
git stash push -m "念のため"

revert したら衝突した

打ち消したいコミットのあとに、同じ場所を触った変更があると起きます。ふつうの衝突と同じように直して、続けます。

git status                 # 衝突しているファイルを見る
git add <直したファイル>
git revert --continue

git revert --abort         # やめるとき

「detached HEAD」と言われた

コミットIDを直接 checkout / switch したときに出ます。枝の上ではなく、コミットの上に直接立っている状態です。そこでコミットすると、どの枝からも辿れないコミットができます(reflog でなら戻せます)。

git switch -c rescue       # いまの場所に枝を付けて助ける
git switch main            # 何もせずに戻る

force push を止められた

! [rejected] main -> main (non-fast-forward)

これは事故を止めてくれている表示です。 一人のリポジトリなら --force-with-lease で押し戻せますが、共有している枝なら revert に切り替えてください。--force は、他人の作業を消す可能性があります。

後片づけ

cd ~
rm -rf undo-lab

練習用なので、まるごと消して構いません。 もう一度読み直すときは、また作ってください。

よくある質問

reset と revert は、結局どちらを使えばいいですか
まだ push していない自分だけのコミットなら reset、すでに push して他の人が取れる状態になっているなら revert です。reset は履歴そのものを書き換えるので、共有したあとに使うと、他の人の手元と食い違って push が通らなくなります。revert は打ち消すコミットを新しく足すだけなので、誰の履歴とも食い違いません。迷ったら revert のほうが安全です。
git reset --hard で消したものは、必ず戻せますか
コミットしてあったものは、reflog から戻せます。戻せないのは、コミットもステージもしていなかった編集です。ファイルを直しただけの状態は Git がまだ何も記録していないため、reflog にも残りません。作業ツリーに変更があるときは、--hard の前に git stash push でどけておくか、いったんコミットしてしまうのが確実です。
reflog はいつまで残りますか
既定では、どこかの枝から辿れるものは90日、辿れなくなったものは30日で期限切れになり、その後の git gc で実際に削除されます。設定は gc.reflogExpire と gc.reflogExpireUnreachable で確認できます。つまり「消したコミットを取り戻す」は、当日や翌日には確実に効きますが、数か月後には効かないことがあるという性質のものです。
git checkout ではなく git restore を使うべきですか
新しく覚えるなら restore と switch のほうです。checkout はブランチの切り替えとファイルの復元という別の仕事を1つのコマンドで兼ねていて、打ち間違いが事故につながりやすい形でした。Git 2.23 で目的ごとに分割されています。checkout も引き続き動くので、古い記事や既存のスクリプトを書き換える必要はありません。
コミットは細かく分けるべきですか、まとめるべきですか
作業中は細かく、共有する前に整える、という順番が扱いやすいです。コミットしてあれば reflog で戻せますが、コミットしていないものは戻せないため、手元に長く貯めるほうがリスクが高くなります。分けすぎたコミットは reset --soft でまとめ直せますし、メッセージも書き直せます。まず残す、あとで整える、という順番にしてください。

まとめ — 理解できたこと

  • 取り消しコマンドは「どこを戻すか」で選ぶ。 作業ツリー・ステージ・HEAD の3つしかない
  • reset の3つは、その3つのうちどこまで戻すかの指定。 --hard だけが作業ツリーまで戻す
  • コミットしてあれば、たいてい戻せる。 reflog は「HEAD が動いた記録」で、消した操作も残っている
  • 本当に消えるのは、コミットしていない編集だけ。 だから、迷ったら先にコミットする
  • push 前は reset、push 後は revert。 共有した履歴は書き換えない
  • stash も drop も戻せる。 stash はコミットとして保存されているので git fsck で拾える

ここまでで、Git を「怖くて触れないもの」から「壊しても戻せるもの」に変えました。戻せると分かっていることが、そのまま試せる回数になります。

参考リンク

次に読む

この記事は 【第0段階】作業場所を作る の 10 / 18 本目です。

記事
← 前の記事Gitの導入と最初の設定 — 入れただけでは事故る3項目
→ 次の記事Windowsの仮想化はどれを選ぶか — Hyper-V・VMware・WSL2

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次