Gitのnot a git repositoryエラーの直し方

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

git status や git commit で fatal: not a git repository (or any of the parent directories): .git と出たら、今いるフォルダーは Git のリポジトリの中ではありません。.git フォルダーのあるフォルダー(またはその下)へ cd で移るか、これから管理を始めるなら git init でリポジトリを作ると、エラーは消えます。

GitHub からプロジェクトを git clone した直後などに、git add や git push がこのエラーで止まったときの、原因と直し方です。私は検証環境でこのエラーを起こし、出たメッセージをそのまま載せました。直したあとにエラーが消えることも確かめています。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。メッセージは英語の設定(LANG を設定していない状態)で出したものです。macOS や Windows(Git for Windows)、日本語に翻訳されたメッセージ、GitHub Desktop などの画面から使う場合は試していません。記事の出力では、検証環境のフォルダーを /path/to/… に置き換えています。フォルダーの移動は検証用のスクリプトで行い、記事では cd として書いています。コマンドは記事では1つずつ分けて書いていますが、検証では && でつないで実行したものもあります。

出たメッセージ

何もない空のフォルダーで git status を実行すると、次の1行が出て止まりました。終了コードは 128 です。

console
$ ls -A
$ git status
fatal: not a git repository (or any of the parent directories): .git

git log、git add .、git commit -m test、git branch、git push、git pull でも、出たメッセージは一字一句同じで、終了コードもすべて 128 でした。

git diff だけは出方が違いました。エラーではなく warning で始まり、そのあとに --no-index を付けたときの使い方の説明が長く続きます(終了コードは 129)。

console
$ git diff
warning: Not a git repository. Use --no-index to compare two paths outside a working tree
usage: git diff --no-index [<options>] <path> <path>

Diff output format options
(以下、オプションの一覧が続くので省略)

git diff の公式ドキュメントにあるとおり、リポジトリの外の git diff は、2つのファイル(またはフォルダー)を比べる使い方として扱われます。検証ではファイルを渡さずに実行したので、使い方の表示になりました。

メッセージの読み方

(or any of the parent directories): .git は、「今のフォルダーにも、その上のどのフォルダーにも .git が見つからなかった」という意味です。Git の公式ドキュメントにある環境変数 GIT_DISCOVERY_ACROSS_FILESYSTEM の説明によると、Git は今のフォルダーに .git がなければ、上のフォルダーへたどって探します。

そのため、リポジトリの中なら、下のフォルダーにいてもエラーにはなりません。逆に、clone したフォルダーの1つ上のように、リポジトリの外にいると、このエラーになります。

一方、git --version や git config --global user.name のように、リポジトリを使わないコマンドは、同じフォルダーでもエラーなく動きました。

直し方1:リポジトリのフォルダーへ移る

たとえば、git clone のあとに cd をしないと、このエラーになります。git clone は、新しいフォルダーを作ってその中にリポジトリを置きます(git clone の公式ドキュメント)。ターミナルの今いる場所は、clone の前と変わりません。

検証では、my-app という名前で clone したあと、そのまま同じフォルダーで git status を実行しました。clone はうまくいっているのに、エラーになります。

console
$ git clone /path/to/origin my-app
Cloning into 'my-app'...
done.
$ ls -A
my-app
$ git status
fatal: not a git repository (or any of the parent directories): .git

clone の元は、検証用に作ったローカルのリポジトリです。ls -A で見ると、リポジトリはさらに1つ下にあります。どこにあるか分からないときは、find で .git を探せます(ここでは2階層下までにしぼっています)。

console
$ find . -maxdepth 2 -name .git
./my-app/.git

.git を持っているフォルダーが、リポジトリのいちばん上です。cd my-app で移ってから実行すると、エラーは消えました(終了コードは 0)。

console
$ cd my-app
$ git status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean
$ git log --oneline
be80cab first commit

リポジトリの中の src のような下のフォルダーからでも、git status は同じ結果になりました。どのフォルダーがリポジトリのいちばん上かは、git rev-parse の --show-toplevel で分かります。今いる場所がリポジトリの中かどうかは、--is-inside-work-tree で確かめられます。

console
$ cd src
$ git rev-parse --show-toplevel
/path/to/demo/my-app
$ git rev-parse --is-inside-work-tree
true

なお、リポジトリの外で git rev-parse --is-inside-work-tree を実行すると、false は出ず、この記事のエラーと同じ fatal: not a git repository … が出ました(終了コードは 128)。

cd せずにフォルダーを指定する

フォルダーを移らずに1回だけ実行したいときは、git -C <フォルダー> を使います。Git の公式ドキュメントにある -C オプションの説明のとおり、指定したフォルダーで起動したかのように動きます。1つ上のフォルダーのまま実行しても、エラーになりませんでした。

console
$ git -C my-app status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

直し方2:新しく始めるなら git init

まだ Git で管理していないフォルダーを、これから管理したいときは、git init でリポジトリを作ります。git init は、そのフォルダーに .git フォルダーを作るコマンドです。

検証では、index.html だけがあるフォルダーで試しました。git init の前はエラー、後は git status が動きます。

console
$ git status
fatal: not a git repository (or any of the parent directories): .git
$ git init
Initialized empty Git repository in /path/to/demo2/.git/
$ ls -A
.git
index.html
$ git status
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	index.html

nothing added to commit but untracked files present (use "git add" to track)

検証環境では、最初のブランチの名前が main になるように設定しています。そのまま git add と git commit もエラーなく終わりました。

console
$ git add index.html
$ git commit -m "first commit"
[main (root-commit) d0b474c] first commit
 1 file changed, 1 insertion(+)
 create mode 100644 index.html
注意

clone したプロジェクトでこのエラーが出たときは、git init ではなく、まず cd でリポジトリのフォルダーへ移ってください。clone したフォルダーの1つ上で git init をすると、そこに履歴が何もない別のリポジトリができてしまいます。

検証で、my-app を clone したフォルダー(my-app の1つ上)で git init を実行してみました。エラーは出なくなりますが、git status には No commits yet と出て、my-app/ は「まだ管理していないファイル」として並びます。git log は、別のエラーになりました(終了コードは 128)。

console
$ git init
Initialized empty Git repository in /path/to/demo/.git/
$ git status
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	my-app/

nothing added to commit but untracked files present (use "git add" to track)
$ git log
fatal: your current branch 'main' does not have any commits yet

my-app の中の履歴は、そのまま残っていました(cd my-app してから git log --oneline を実行すると be80cab first commit が出ました)。間違えて作ったリポジトリは、そのフォルダーにできた .git フォルダーを消すと元に戻ります。検証では、rm -rf .git のあとの git status が、最初と同じ fatal: not a git repository … に戻りました。消すのは、間違えて git init をしたフォルダーの .git だけです。

git init を打ったフォルダーは、出力の Initialized empty Git repository in …/.git/ に出ます。思っていたフォルダーと違わないか、ここで確かめられます。

​Posted by 86