git revert
別名: revert / リバート / 打ち消しコミット / git revert -m
git revert は、指定したコミットの変更を打ち消す新しいコミットを作る Git のコマンドである。
履歴を消さないので、push 済みで他人と共有しているコミットを取り消すときに使う。
公開: 更新:
定義
git revert は、既存のコミットが入れた変更を逆向きに適用し、その結果を新しいコミットとして記録する Git のコマンドである。
元のコミットは履歴に残ったままになる。git revert HEAD を打つと、直前のコミットを打ち消すコミットが 1 つ増える。
詳細
公式ドキュメント(新しいタブで開く)は、作業ツリーに未コミットの変更が無い状態で実行するよう求めている。
同じ行が後のコミットで書き換えられていると衝突し、処理が途中で止まる。
直して git add した後に git revert --continue で続け、やめるなら git revert --abort で始める前に戻す。
git revert abc1234
git revert -m 1 def5678
git revert --no-commit HEAD~3..HEADマージコミットは親が 2 つあるため、-m で残す側の親番号を渡す。--no-commit は打ち消しを作業ツリーとインデックスに置くだけで、複数のコミットを 1 つにまとめて戻せる。
よくある誤解
git revert は「そのコミットの時点に戻す」コマンドと思われやすい。
実際に戻るのは指定したコミット 1 つ分の差分だけで、その後のコミットはそのまま残る。
マージコミットを revert した後に同じブランチをもう一度マージしても、変更は戻ってこない。
Git は打ち消したマージの変更を二度と取り込まないものとして扱うからである。
修正を積んだブランチを取り込み直すなら、revert のコミットをさらに revert してからマージする。
関連
履歴そのものを巻き戻すのは git reset で、共有前のコミットに使う。
衝突したときの直し方は Git revert でコンフリクトが出て元に戻せない にまとめている。