「Fatal: 'origin' does not appear to be a git repository」エラーの原因と解決方法

Gitはソフトウェア開発においてソースコードの変更履歴を追跡するために使われる分散型バージョン管理システムです。GitHubはGitベースのバージョン管理のためのオンラインホスティングサービスであり、どちらも開発現場で広く利用されています。しかし最近、「git」コマンドが実行できないという報告が多数寄せられています。

あなたは決して一人ではありません。Gitのワークフローをマスターしたつもりでも、見たことのないエラーに遭遇することは珍しくありません。Gitを使っていると、戸惑うような、時に威圧感のあるエラーメッセージに出くわすのはほぼ避けられないことです。まず覚えておきたいのは、他の多くのGitユーザーも同じような苦労を経験しているということです。

Fatal: 'origin' does not appear to be a git repository エラーは、Gitユーザーにとって馴染み深い厄介な問題です。原因箇所が分からなければ、根本的な原因を突き止めるのは難しいでしょう。しかし、Gitを諦める前に、このエラーの原因、診断方法、そして今後の予防策を素早く学ぶことができます。

Fatal: 'origin' does not appear to be a git repository エラーとは？

git init コマンドは新しいGitリポジトリの作成を開始するコマンドです。このコマンドは単にフォルダをGitリポジトリとしてセットアップするだけで、あるリポジトリと別のリポジトリを接続するものではありません。

一方、git clone コマンドはローカルリポジトリをリモートリポジトリに接続します。これは、Gitがプロジェクトのコードの出所を把握しており、クローンした場所からコミットのプッシュ先を推測できるためです。

新しいリポジトリを作成した後、コードのプッシュ先をGitに指示しないままコミットしようとすると、「fatal: 'origin' does not appear to be a git repository」というエラーが発生します。

Gitリポジトリとは何か

Gitリポジトリには、プロジェクトのさまざまなバージョンのファイル群が格納されています。これらのファイルはリポジトリからユーザーのローカル環境へ取り込まれ、内容の更新や修正が行われます。こうしたバージョンはVCS（バージョン管理システム）によって作成され、「リポジトリ」と呼ばれる場所に保存されます。既存のGitリポジトリからコンテンツをコピーすることを「クローン」と呼びます。

クローン処理が完了すると、ユーザーはリポジトリ全体を自分のマシン上に取得します。クローン後、Gitは今後の作業もそのユーザーによって行われるものと認識します。ユーザーは新しいリポジトリを作成したり、既存のリポジトリを削除したりすることもできます。リポジトリを削除する最も簡単な方法は、リポジトリのフォルダを削除することです。

Gitリポジトリでの作業とは、実質的にGitプロジェクトとして設定されたディレクトリでの作業のことです。ローカルマシンやリモートサーバー上のほぼすべてのディレクトリに対してGitを使用できます。

Gitプロジェクトがコマンドを受け付けない理由や、リモートリポジトリが認識されない理由を正しく診断するには、Gitがリポジトリとやり取りする際に何を確認しているのかを理解する必要があります。

ローカルかリモートかを問わず、任意のディレクトリはGitで初期化されている必要があります。つまり、次のコマンドを実行しなければなりません。
git init

ローカルディレクトリでこのコマンドを実行すると、そのディレクトリはGitリポジトリに変換され、成功メッセージが表示されます。また、すべてのGitリポジトリには重要なファイルや参照ポイントが保存される .git ディレクトリ があることにも気づくでしょう。

一方、リモートリポジトリを初期化する際は、慣例として --bare オプションを使用します。
git init --bare

これにより「ベア（bare）」リポジトリが作成されます。ベアリポジトリとは、Gitで初期化された空のディレクトリであり、送信されたGitコマンドを受け取って実行できるものです。ベアリポジトリは、複数のGitユーザーがプロジェクトのクローン、プッシュ、プルを行える優れた「ハブ」として機能します。

Gitリポジトリは自動的にはリモートリポジトリと接続されません。リモートリポジトリの場所を指定せずに変更をプッシュしようとすると、「fatal: 'origin' does not appear to be a git repository」エラーが発生します。

Fatal 'origin' does not appear to be a git repository エラーの原因

このエラーは、Gitリポジトリとして認識されていないディレクトリでクローンやその他のコマンドを実行しようとしたときに発生します。ディレクトリやリモートのファイルパスでGitが初期化されていないか、アクティブなリポジトリとしてアクセスしようとしているファイルパスが間違っている可能性があります。このエラーを引き起こす要因は以下の通りです。

• Originの欠落：「origin」の設定が存在しない場合に発生します。「github-fork」への参照が欠けていると、一部のコマンドが正しく動作しません。
• 誤ったURL：アプリケーションで設定されたURL設定が誤っている場合があり、修正が必要です。その結果、一部のコマンドが正常に機能しなくなります。

つまりGitは、操作しようとしているリポジトリがGitプロジェクトとして認識できないことを伝えています。すべて正しく設定したつもりでもこのエラーが出ると苛立つかもしれませんが、心配無用です。単純なタイプミスが原因であることもあります。

問題の性質について基本的な理解が得られたところで、次は解決策を見ていきましょう。このエラーを診断・修復するために何ができるのか、読み進めてください。

Fatal: 'origin/master' does not appear to be a git repository エラーのトラブルシューティング

このエラーは作業を中断させ、時間を浪費させるため、非常にストレスになります。この種の不具合を未然に防ぐ一つの方法は、デバイスを定期的にスキャンしてクリーンな状態を保つことです。小さな問題が積み重なって大きな混乱になるのを防ぎましょう。

それでもこのエラーに遭遇した場合は、以下の手順で簡単に解決できるはずです。

対処法1：Originを追加する

git init コマンドで作成したばかりのGitリポジトリにコミットしようとすると、「fatal: 'origin' does not appear to be a git repository」エラーが発生することがあります。これは、git init がローカルリポジトリをリモートリポジトリに接続しないためです。次のコマンドで確認できます。
git remote -v

「origin」という名前のリモートリポジトリが存在しない場合は、以下の手順で手動的に追加してください。

1. 「Command」キーと「Space」キーを同時に押してSpotlightを開きます。
2. 「ターミナル」と入力し、「Return」キーを押します。
3. 次のコマンドを入力して「Return」キーを押します：git remote -v
4. 「origin」という名前のリモートリポジトリが一覧に表示されているか確認します。
5. 表示されていなければ、「origin」が欠落しています。
6. 次のコマンドでoriginを追加します：git remote add origin url/to/your/fork

その後、問題が解消されたかどうかを確認してください。

対処法2：リモートリポジトリのファイルパスを確認する

リモートリポジトリからコンテンツをクローン、プッシュ、プルしようとする際、Gitユーザーは頻繁にこのエラーに遭遇します。リモートリポジトリのファイルパスを必ず再確認しましょう。確認方法はいくつかあります。

クローンを行う場合、必要なリポジトリアクセス権を持っているか確認してください。GitHubの公開リポジトリをクローンするのでなければ、SSH経由で接続しているはずです。同様に、クローンコマンドの構文も確認しましょう。以下はHTTP経由でリポジトリに接続する基本的なクローンコマンドの例です。
git clone https://github.com/WordPress/WordPress.git

お好みのターミナルエミュレータでこのコマンドを実行すると、「WordPress」というディレクトリが作成され、WordPressのコアファイルがすべて含まれます。.git ディレクトリとプロジェクトの全履歴も含まれるため、このディレクトリは完全に機能するローカルのGitリポジトリとなり、リモートリポジトリ（GitHub側）の情報も適切に設定されます。

しかし、HTTPアクセスのないプライベートサーバーと通信する場合は、適切な権限を持つサーバーユーザーを含むように構文を変更する必要があります。そのため、プライベートGitサーバーを構築する際は、リポジトリアクセス権を持つ専用の「git」ユーザーを作成しておくのが良い習慣です。
git clone admin@example.com:/home/user/production.git

GitHubのHTTP版とは異なり、このクローンURLには admin@example.com のようなユーザー情報が含まれています。ここでの「user」は、サーバーのGitリポジトリへのアクセス権限を持つサーバーユーザーです。接続先は、サーバーのホスト名、ドメイン名、またはIPアドレスです。ユーザーとサーバーの指定は、コロン（:）でファイルパスと区切られます。

この場合、ファイルパスが極めて重要です。ファイルパスはリポジトリの正確な場所と名前を示します。上記の例では、リポジトリは production.git というディレクトリです。

リポジトリのディレクトリには必ず .git 拡張子を使用してください。production.git ディレクトリは、ユーザーのホームディレクトリである /home/user 内に配置されています。

この構文を正確に再現しないと、「fatal: 'origin' does not appear to be a git repository」エラーが発生します。

対処法3：OriginをMasterに変更する

Masterからプルしようとしている場合は、リモートリポジトリの追加や削除を行う前に、originをmasterに変更する必要があります。以下の手順で実行します。

1. 「Command」キーと「Space」キーを同時に押してSpotlightを開きます。
2. 「ターミナル」と入力し、「Return」キーを押します。
3. 次のコマンドを入力して、originをmasterに変更します：git pull origin master

「fatal: 'origin' does not appear to be a git repository」の問題が解消されたかどうかを確認してください。

対処法4：破損したHEADファイルを修復する

上記のトラブルシューティング手順でも問題が解決しない場合は、HEADファイルに問題がある可能性があります。このファイルには、現在のブランチを指すポインタとなる1行が含まれています。

Git初心者の場合、「ブランチ」という用語も馴染みがないかもしれません。ブランチとは、プロジェクトへの変更をテストするために使用できるリポジトリのバージョンのことです。すべてのリポジトリにはメインブランチがあり、これが信頼できる正本（ソース・オブ・トゥルース）となり、本番環境にデプロイすべきバージョンです。メインブランチに変更を加えたい場合は、プロジェクトの別バージョン（ブランチ）を作成して変更をテストできます。新しいブランチを作成すると、Gitは現在作業中のブランチを反映するようにHEADファイルを更新します。

しかし、場合によってはHEADファイルが破損し、Fatal: 'origin' does not appear to be a git repository エラーが発生することがあります。HEADファイルを確認するには、次のコマンドで内容を出力します。
cat .git/HEAD

このコマンドを実行すると、現在のブランチ名が表示されるはずです。作業中の現在のブランチが含まれていない場合は、ファイルを更新する必要があります。次のコマンドで更新できます。
echo 'ref: refs/heads/<branch_name>' > .git/HEAD

まとめ

Fatal: 'origin' does not appear to be a git repository エラーに遭遇しても、焦る必要はありません。このエラーは、現在の作業ディレクトリが追跡対象になっていないことをGitが知らせているのです。この記事で紹介した基本の手順を思い出して実践しましょう。

• originを手動で追加する。
• ディレクトリ名を正しく入力したか確認する。
• リポジトリを正しく作成したか確認する。ディレクトリに .git リポジトリがない場合は、git init でリポジトリを適切に初期化するか、既存のリポジトリをクローンする。
• 現在のブランチのHEADファイルに正しい情報が含まれているか確認する。含まれていない場合は、ファイルの内容を ref: refs/heads/<branch_name> に変更する。

上記のトラブルシューティング手順に従えば、ほとんどすべてのケースで数分以内にエラーを解決できるはずです。