Gitでよくあるエラーと解決法まとめ【初心者向けトラブル対応ガイド】

Gitでよくあるエラーとは？

Gitは強力なツールですが、操作ミスや環境の違いによって様々なエラーが発生することがあります。本記事では、初心者がつまずきやすいエラーとその対処法を具体的に解説します。

---

エラー1：push rejected（pushが拒否される）

原因

• リモートリポジトリに自分のローカルにないコミットが存在する

解決法

git pull origin main --rebase

その後、再度pushします。

git push origin main

---

エラー2：CONFLICT（コンフリクト発生）

原因

• マージやpull時に、同じ箇所が他の人の変更と競合している

解決法

1. 競合箇所を手動で修正
2. 修正後に以下を実行

git add ファイル名
git commit

---

エラー3：fatal: refusing to merge unrelated histories

原因

• 初回のpullで履歴が一致しない場合に発生

解決法

git pull origin main --allow-unrelated-histories

---

エラー4：fatal: not a git repository

原因

• .git

  フォルダがないディレクトリでGit操作を実行した

解決法

リポジトリのディレクトリに移動するか、以下のコマンドで初期化：

git init

---

エラー5：Permission denied (publickey)

原因

• SSH接続でGitHubなどにアクセスできない

解決法

• SSHキーが登録されていないか、設定ミス
• 対処：GitHubに公開鍵を登録し、SSH認証の確認

ssh -T git@github.com

---

エラー6：Your branch is behind 'origin/main'

原因

• リモートリポジトリに新しい変更があり、ローカルが古い状態になっている

解決法

git pull origin main

でローカルを最新の状態に更新してから作業を続けます。

---

エラー7：変更をコミットせずにブランチを切り替えようとした

原因

• 作業中の変更が残っている状態でcheckoutしようとした

解決法

git stash

で一時退避し、その後checkout。作業復帰は：

git stash pop

---

まとめ：エラーの原因と対処法を知って安心運用

Gitのエラーは焦らず、原因を見極めて正しいコマンドを使えば必ず解決できます。よくあるパターンを理解しておくことで、トラブルに強いGitユーザーを目指しましょう。