最初のコミットでgit reset HEAD~1が失敗する原因と直し方

​​Git​コマンドライン,トラブルシュート

コミットが1つしかないリポジトリで git reset HEAD~1 を実行すると、fatal: ambiguous argument 'HEAD~1': unknown revision で止まります。HEAD~1 は「今のコミットの親」を指しますが、最初のコミットには親がないためです。git init してすぐに間違えて作った最初のコミットを、取り消そうとしたときに出るエラーです。最初のコミットを取り消したいときは git update-ref -d HEAD を、中身やメッセージを直したいだけなら git commit --amend を使うと解決します。この2つの方法なら、エラーは出ずに終了コード 0 で終わります。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。手元に作ったリポジトリだけで試しており、push 済みのコミットや GitHub などのリモートリポジトリ、Windows・macOS での動作は試していません。出力をそろえるためにコミットの日時を固定しているので、コミットのハッシュは手元で試すと変わります。

エラーの全文と、何が見つからないのか

README.md と index.html を「最初のコミット」として1回だけコミットしたリポジトリです。git rev-list --count HEAD で数えると、コミットは1つです。

console
$ git log --oneline
b5fd89b 最初のコミット

$ git rev-list --count HEAD
1

このコミットを取り消そうとして git reset HEAD~1 を実行すると、次のエラーが出ました。終了コードは 128 です。

console
$ git reset HEAD~1; echo "exit=$?"
fatal: ambiguous argument 'HEAD~1': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'
exit=128

1行目は「HEAD~1 という引数が、Git が見つけられるリビジョン(コミットを指す書き方)でも、作業ツリーにあるファイルでもない」という意味です。--soft や --hard を付けても、まったく同じ3行で止まりました。エラーのあとに git status --short を実行しても何も表示されず、リポジトリは何も変わっていません。

Git のリビジョンの書き方を説明した公式リファレンスによると、<rev>~ はそのコミットの最初の親を、<rev>~<n> は最初の親を n 回たどった先のコミットを指します。HEAD~1 は「今のコミット(HEAD)の親」です。

コミットに親があるかどうかは、git cat-file -p でコミットの中身を表示すると分かります。コミットが2つあるリポジトリの新しいほうには parent の行があり、1つ前のコミットのハッシュが書かれています。

console
$ git log --oneline
6edbe20 トップページを追加
79fe6f2 最初のコミット

$ git cat-file -p HEAD
tree 90a332b7825d7046172bf102c8a259a173591097
parent 79fe6f2920158a2506dbc71a0eb6248393c42b96
author Neko <neko@example.com> 1794618300 +0900
committer Neko <neko@example.com> 1794618300 +0900

トップページを追加

一方、コミットが1つだけのリポジトリで同じことをすると、parent の行がありません。たどる先がないので、HEAD~1 は何も指せません。

console
$ git cat-file -p HEAD
tree 90a332b7825d7046172bf102c8a259a173591097
author Neko <neko@example.com> 1794618000 +0900
committer Neko <neko@example.com> 1794618000 +0900

最初のコミット
上の段はコミットが2つあるとき。「トップページを追加」が HEAD で、その親の「最初のコミット」が HEAD~1 になり、git reset HEAD~1 で HEAD をそこへ動かせる。下の段はコミットが1つだけのとき。「最初のコミット」が HEAD で親がなく、HEAD~1 はどこにもないので、エラーで止まる
コミットが1つだけだと HEAD~1 が指すコミットがない

コミットが2つあるリポジトリでは、同じ git reset HEAD~1 がエラーなく通り、HEAD が「最初のコミット」へ戻りました。2つ目のコミットで足した index.html は、ファイルとしてフォルダに残っています。

console
$ git reset HEAD~1; echo "exit=$?"
exit=0

$ git log --oneline
79fe6f2 最初のコミット

$ git status --short
?? index.html

「Use '–' to separate…」の案内は気にしなくてよい

2行目と3行目は、引数がリビジョンなのかファイル名なのかを区別したいなら -- で分けてください、という一般的な案内です。Git 2.43.0 のソース setup.c を読むと、リビジョンとしてもファイル名としても解釈できない引数に、最後の手段として出すメッセージだと分かります。

案内どおり git reset HEAD~1 -- と -- を付けても、メッセージが変わるだけで、やはり失敗しました。

console
$ git reset HEAD~1 --; echo "exit=$?"
fatal: Failed to resolve 'HEAD~1' as a valid revision.
exit=128

「HEAD~1 をリビジョンとして解決できない」という、原因をそのまま言ったメッセージになります。-- を付けても直らないのは、ファイル名と取り違えられたからではなく、HEAD~1 が指すコミットがそもそもないからです。

最初のコミットを取り消す:git update-ref -d HEAD

最初のコミットを「なかったこと」にするには、コミットを指している今のブランチ(ref)そのものを消します。git update-ref の公式リファレンスによると、-d は指定した ref を消すオプションです。HEAD を渡すと、HEAD が指している今のブランチ(ここでは main)が消え、コミットが1つもない状態に戻ります。

console
$ git update-ref -d HEAD; echo "exit=$?"
exit=0

$ git log --oneline; echo "exit=$?"
fatal: your current branch 'main' does not have any commits yet
exit=128

$ git status
On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
	new file:   README.md
	new file:   index.html

git status は No commits yet と表示し、git init 直後に git add しただけの状態に戻りました。2つのファイルはステージに残っているので、git reset --soft HEAD~1 で期待していた結果と同じです。このまま中身を直してコミットし直すと、新しい最初のコミットができました。

console
$ git commit -q -m "最初のコミット(やり直し)"; echo "exit=$?"
exit=0

$ git log --oneline
982d986 最初のコミット(やり直し)

git update-ref -d HEAD で消えるのはブランチだけで、コミット b5fd89b はリポジトリに残っていました。そのハッシュの種類を git cat-file -t で調べると、commit と答えました。

console
$ git cat-file -t b5fd89b121fa6eb4fe71e320ce2bb8d8b1c351ed; echo "exit=$?"
commit
exit=0

ステージからも外したいとき

git reset HEAD~1(--mixed)のように、ファイルをステージからも外したいときは、続けて引数なしの git reset を実行します。ファイルは未追跡(??)になり、フォルダには残りました。

console
$ git update-ref -d HEAD; echo "exit=$?"
exit=0

$ git reset; echo "exit=$?"
exit=0

$ git status --short
?? README.md
?? index.html

ここで git reset HEAD と HEAD を書くと、HEAD が指すブランチ(main)にまだコミットがないので、同じ種類のエラーになりました。

console
$ git reset HEAD; echo "exit=$?"
fatal: ambiguous argument 'HEAD': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'
exit=128

git reset の公式リファレンスでは、引数を省いたときのコミットは HEAD です。それでも結果が違うのは、Git 2.43.0 のソース builtin/reset.c で、引数を省いてコミットがまだないときは、空の状態へ戻す扱いになっているからです。HEAD と書いた引数のほうは、その前の段階でリビジョンとして解釈できずにエラーになります。

注意

git update-ref -d HEAD は、コミットが1つだけのときに使うコマンドです。コミットが2つ以上あるブランチで実行すると、ブランチがまるごと消え、git log は does not have any commits yet と答えました。git reflog も同じエラーで、消える前のハッシュを調べられませんでした。検証では、事前に控えたハッシュを git reset --soft <ハッシュ> に渡して元に戻せました。実行する前に git rev-list --count HEAD が 1 であることと、git log --oneline のハッシュを確かめておいてください。

中身やメッセージを直したいだけなら git commit –amend

取り消す目的が「ファイルを足し忘れた」「メッセージを直したい」なら、取り消さずに作り直すほうが手軽です。git commit の公式リファレンスによると、--amend は今のブランチの先頭のコミットを、新しいコミットで置き換えるオプションで、新しいコミットの親は元のコミットと同じになります。最初のコミットは親がないので、作り直したコミットも親がないままです。

足し忘れた style.css を git add してから --amend を付けてコミットすると、エラーは出ず、コミットは1つのまま中身とメッセージが置き換わりました。

console
$ git commit -q --amend -m "最初のコミット(style.css を追加)"; echo "exit=$?"
exit=0

$ git log --oneline
af01d5d 最初のコミット(style.css を追加)

$ git rev-list --count HEAD
1

$ git show --stat --format=%s HEAD
最初のコミット(style.css を追加)

 README.md  | 1 +
 index.html | 1 +
 style.css  | 1 +
 3 files changed, 3 insertions(+)

--amend の使い方は、別の記事「git commit –amendで直前のコミットを直す方法」でも詳しく扱っています。2つ目以降のコミットを取り消すときの --soft・--mixed・--hard の違いは、別の記事「git resetで直前のコミットを取り消す3つの方法の違い」にまとめています。

​Posted by 86