git reset --hard を打って、画面が一瞬で静かになったときのことを覚えています。2時間ぶんの作業が消えました。 正確には、消えたと思いました。
Git を使っていて一番怖いのは、やり直し方を知らないまま操作することです。知らないと、コミットするのが怖くなり、ブランチを切るのが怖くなり、最後には「触らないほうが安全」になります。それが一番危ない状態です。
この記事は、「やってしまった」を種類ごとに分けて、全部わざと起こして、全部戻す回です。読むだけでは身に付かないので、壊してよい練習用のリポジトリを作って、実際に踏みます。
対象レベル: PC入門 / 区分: 必修
この記事でわかること
- Git には3つの置き場所があり、取り消しコマンドは「どこを戻すか」で選ぶこと
resetの--soft/--mixed/--hardが、それぞれ何を戻して何を残すか- 消したコミットは、しばらく残っていること(そして、残らないものは何か)
- push したあとは
revert、push 前ならresetという使い分けの理由 - 作業を中断したいときの
stashと、その stash を消してしまったときの戻し方
この記事でやること
- 壊してよい練習用リポジトリを作る
- 3つの置き場所を、コマンドの出力で見る
resetの3つを、同じ状態から3回試して違いを見るreset --hardで消したコミットを、reflogで取り戻す- push 済みの間違いを
revertで戻す stashを消してしまい、それも取り戻す
先に知る言葉
この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| 作業ツリー | いまエディタで開いているファイルそのもの。フォルダの中身 |
| ステージ(index) | git add したものが入る、コミット直前の控え室 |
| HEAD | 「いま自分がどのコミットの上にいるか」を指す矢印 |
HEAD~1 | HEAD の1つ前のコミット。~2 なら2つ前 |
| reflog | HEAD が動いた履歴。コミット履歴とは別物で、手元にしか無い |
| 到達できないコミット | どのブランチからも辿れなくなったコミット。消えたように見えるが、しばらく残る |
準備 — 壊してよいリポジトリを作る
本物のリポジトリで練習しないでください。 この記事は、わざと壊す手順を含みます。
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 していない |
MM | add したあとに、また直した |
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つ目」は履歴に残ったまま、その変更だけが取り消されています。 何が起きたかが履歴に残るので、あとから読む人が困りません。
「間違いを消したい」と「間違いを取り消したい」は、別のことです。 共有したあとに消しにいくと、他人が持っている履歴と食い違い、その人の手元で「知らないコミットが増えた/減った」が起きます。起きたことは残し、打ち消した事実も残す——これが、複数人で作業するときに履歴を信用できる理由です。一人で開発していても、半年後の自分は他人なので、同じ理屈が効きます。
reset | revert | |
|---|---|---|
| 履歴 | 書き換える(消える) | 足す(残る) |
| 共有した後 | 使わない | 使う |
| 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 |
| 3 | reset --hard でコミットを2つ飛ばした | git reflog → git reset --hard <id> |
| 4 | push 済みのコミットが間違っていた | git revert |
| 5 | git 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 を「怖くて触れないもの」から「壊しても戻せるもの」に変えました。戻せると分かっていることが、そのまま試せる回数になります。
参考リンク
- Git 公式ドキュメント —
git reset/git revert/git reflog - Git 公式ドキュメント —
git restoreとgit switchの導入経緯 - Pro Git(日本語版)— 「歴史の書き換え」の章
次に読む
この記事は 【第0段階】作業場所を作る の 10 / 18 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。

コメント