この記事の要点

Git のエラー一覧入口ページ カテゴリ: リモート / プッシュ系 / 作業ツリー・インデックス / 参照名・ファイル指定 / ロック・プロセス 切り分け順: エラーメッセージ最初の 1 行を読む → git status 確認 → git log --oneline -20 頻出: non-fast-forward / merge conflict / Permission denied / detached HEAD / index.lock 子ページから個別のエラーを選択

Git エラーの 5 大カテゴリ

カテゴリ	典型エラー	原因の方向性
リモート/プッシュ系	! [rejected] non-fast-forward / Permission denied	リモートが進んでいる / 認証問題
作業ツリー/インデックス	Your local changes would be overwritten / Unmerged paths	未コミットの変更とぶつかる
参照名・ファイル指定	pathspec did not match any files / ambiguous argument	typo / ファイル存在しない
マージ/リベース	CONFLICT (content): Merge conflict / could not apply	同じ箇所を別 commit で変更
ロック・プロセス	Unable to create '.git/index.lock' / Another git process	既存 Git プロセス / 異常終了の残骸

エラー出たときの調査フロー

1. エラーメッセージの最初の 1 行を読む（fatal: / error: / hint: の見出しが種類を表す）
2. git status で作業ツリーの状態を確認
3. git log --oneline -20 で最近のコミット履歴を確認
4. git remote -v でリモートの設定を確認
5. git branch -avv でブランチとリモート追従を確認
6. 慌てて git reset --hard や git push --force は取り返しがつかないので慎重に

頻出エラー Top 10

エラー	原因	対処
! [rejected] non-fast-forward	リモートに別 commit がある	git pull --rebase → 解決 → git push
Permission denied (publickey)	SSH 鍵が設定されていない	ssh-add ~/.ssh/id_ed25519 / GitHub に公開鍵登録
fatal: refusing to merge unrelated histories	履歴が無関係なリポジトリ同士をマージ	--allow-unrelated-histories
Your local changes would be overwritten by merge	未コミット変更とマージが衝突	git stash → git pull → git stash pop
CONFLICT (content): Merge conflict in xxx	同じ箇所を別 commit で変更	ファイル編集 → git add → git commit
fatal: pathspec 'xxx' did not match any files	ファイルパスの typo	正しいパスに直す
fatal: Unable to create '.git/index.lock'	別 Git プロセスが動いている / 異常終了残骸	rm -f .git/index.lock
detached HEAD state	ブランチでない位置をチェックアウト	git switch -c new-branch で新規ブランチ作成
fatal: not a git repository	カレントディレクトリが Git 管理下にない	git init / 正しいディレクトリに移動
HTTP 403 / 401 push 時	HTTPS 認証情報が古い / Personal Access Token 失効	git credential 削除 / PAT 再発行

「やらかし」リカバリ集

間違って commit した

# 直前の commit を取り消し（変更は残す）
git reset --soft HEAD~1

# 直前の commit メッセージを書き換え（既に push 済みでも可だが force push 必要）
git commit --amend

# 既に push 済みなら revert（新規 commit で打ち消す）
git revert HEAD
git push

間違ったブランチで作業した

# 現在の変更を別ブランチに移す
git stash
git checkout 正しいブランチ
git stash pop

# commit 済みなら cherry-pick
git checkout 正しいブランチ
git cherry-pick <間違ったブランチの commit ハッシュ>

# 間違ったブランチから commit を取り消し
git checkout 間違ったブランチ
git reset --hard HEAD~1

大事なファイルを消した / 上書きした

# 直前の commit 状態に戻す
git checkout HEAD -- path/to/file

# 数 commit 前の状態を取得
git checkout HEAD~3 -- path/to/file

# reflog で「失われた」commit を探す
git reflog
# 該当 commit を確認
git show 
# その状態に戻す
git reset --hard 

conflict が出たけど解決方法がわからない

# 衝突しているファイル一覧
git status

# 衝突箇所には以下が入っている
# <<<<<<< HEAD
# 自分の変更
# =======
# 相手の変更
# >>>>>>> branch_name

# 手動で編集して <<<<< >>>>>>> を消す
# またはツールを使う
git mergetool

# 解決したら
git add <ファイル>
git commit
# rebase 中なら
git rebase --continue

# 全部取り消したい
git merge --abort
git rebase --abort

push 拒否されたとき

# non-fast-forward の典型
git pull --rebase    # リモートの変更を取り込む（rebase 方式）
git pull             # マージ方式

# 自分の変更を確実に残したい場合
git pull --rebase
# conflict が出たら個別解決 → git rebase --continue

# ★ NG: 安易に強制 push しない（チームメンバーの commit を消す可能性）
# git push --force  ← 危険

# ★ 個人ブランチで完結する場合のみ許容
git push --force-with-lease  # 他人の変更があれば拒否（より安全）

子ページ（個別エラー詳細）

• ! [rejected] non-fast-forward の対処
• fatal: refusing to merge unrelated histories の対処
• Permission denied (publickey) の対処
• fatal: Unable to create '.git/index.lock' の対処
• CONFLICT (content): Merge conflict の解決手順
• detached HEAD 状態からの復帰
• 各種 git reset / revert / restore の使い分け

各エラーの詳細解説は子ページを参照してください。