Gitトラブル解決ガイド - よくある問題と対処法

1
2
3
4
5
6
7
8

# 現在のブランチと状態を確認
git status

# コミット履歴を確認
git log --oneline -5

# リモートとの差分を確認
git log origin/main..HEAD --oneline

1
2
3
4
5
6
7
8

$ git branch
* main
  feature/new-function

$ git log --oneline -3
a1b2c3d (HEAD -> main) 誤ってmainにコミットした変更
e4f5g6h 前回の正しいコミット
i7j8k9l さらに前のコミット

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 1. 移動先のブランチに切り替え
git switch feature/new-function

# 2. mainブランチの最新コミットを取り込む（cherry-pick）
git cherry-pick main

# 3. mainブランチに戻る
git switch main

# 4. mainブランチのコミットを取り消す（直前の1コミット）
git reset --hard HEAD~1

1
2
3
4
5
6
7

$ git log --oneline -3 feature/new-function
b2c3d4e (HEAD -> feature/new-function) 誤ってmainにコミットした変更
...

$ git log --oneline -3 main
e4f5g6h (HEAD -> main) 前回の正しいコミット
i7j8k9l さらに前のコミット

1
2
3
4
5
6
7
8
9

# 移動先ブランチに切り替え
git switch feature/new-function

# 複数コミットをcherry-pick（古い順に適用）
git cherry-pick e4f5g6h..a1b2c3d

# mainブランチに戻ってリセット
git switch main
git reset --hard HEAD~3  # 移動したコミット数分だけ戻す

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 移動先ブランチでcherry-pick
git switch feature/new-function
git cherry-pick main
git push origin feature/new-function

# mainブランチをリセット
git switch main
git reset --hard HEAD~1

# 強制プッシュ（--force-with-leaseを使用）
git push --force-with-lease origin main

1
2
3
4
5

# エディタが開き、コミットメッセージを編集できる
git commit --amend

# または、コマンドラインで直接メッセージを指定
git commit --amend -m "修正後のコミットメッセージ"

1
2
3
4
5
6
7

$ git log --oneline -1
a1b2c3d feat: ユーザー認証機能を実装（タイポあり）

$ git commit --amend -m "feat: ユーザー認証機能を実装"

$ git log --oneline -1
d4e5f6g feat: ユーザー認証機能を実装

1
2
3
4
5

# 追加したいファイルをステージング
git add forgotten-file.js

# --no-editオプションでメッセージを変更せずにコミットに追加
git commit --amend --no-edit

1
2
3
4
5
6
7
8

# コミットをソフトリセット（変更は保持）
git reset --soft HEAD~1

# 除外したいファイルをアンステージ
git restore --staged unwanted-file.js

# 再度コミット
git commit -c ORIG_HEAD

1
2
3
4
5

# コミットメッセージを修正
git commit --amend -m "修正後のメッセージ"

# 安全な強制プッシュ
git push --force-with-lease origin feature/my-branch

1
2
3
4
5
6
7
8

# 直前のコミットを打ち消す
git revert HEAD

# 特定のコミットを打ち消す
git revert a1b2c3d

# 複数コミットを打ち消す（個別にrevertコミットが作成される）
git revert HEAD~3..HEAD

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

$ git log --oneline -3
a1b2c3d (HEAD -> main) 問題のあるコミット
e4f5g6h 前回のコミット
i7j8k9l さらに前のコミット

$ git revert HEAD
[main b2c3d4e] Revert "問題のあるコミット"
 1 file changed, 1 deletion(-)

$ git log --oneline -4
b2c3d4e (HEAD -> main) Revert "問題のあるコミット"
a1b2c3d 問題のあるコミット
e4f5g6h 前回のコミット
i7j8k9l さらに前のコミット

1
2
3
4
5

# ローカルで履歴を書き換え
git reset --hard HEAD~1

# 強制プッシュ（安全版）
git push --force-with-lease origin feature/my-branch

1
2
3
4
5

# 他の人がプッシュしていた場合、force-with-leaseは失敗する
$ git push --force-with-lease origin main
To github.com:user/repo.git
 ! [rejected]        main -> main (stale info)
error: failed to push some refs to 'github.com:user/repo.git'

1
2
3

git fetch origin
git log origin/main..HEAD --oneline
git log HEAD..origin/main --oneline

1
2
3
4
5
6
7
8

# 特定のコミットを直接チェックアウト
git checkout a1b2c3d

# タグをチェックアウト
git checkout v1.0.0

# リモートブランチを直接チェックアウト
git checkout origin/main

1
2
3
4
5
6
7

$ git checkout a1b2c3d
Note: switching to 'a1b2c3d'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by switching back to a branch.
...

1
2
3
4
5
6
7

$ git status
HEAD detached at a1b2c3d

$ git branch
* (HEAD detached at a1b2c3d)
  main
  feature/new-function

1
2
3
4

# ブランチに切り替え
git switch main
# または
git checkout main

1
2
3
4

# 現在の状態から新しいブランチを作成
git switch -c save-my-work
# または
git checkout -b save-my-work

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

$ git status
HEAD detached at b2c3d4e

$ git log --oneline -3
b2c3d4e (HEAD) detached状態での作業コミット
a1b2c3d 元のコミット
e4f5g6h さらに前のコミット

$ git switch -c save-my-work
Switched to a new branch 'save-my-work'

$ git status
On branch save-my-work

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# reflogでHEADの移動履歴を確認
$ git reflog
c3d4e5f (HEAD -> main) HEAD@{0}: checkout: moving from b2c3d4e to main
b2c3d4e HEAD@{1}: commit: detached状態での作業コミット
a1b2c3d HEAD@{2}: checkout: moving from main to a1b2c3d

# 迷子のコミットからブランチを作成
$ git branch recovered-work b2c3d4e

# または直接cherry-pick
$ git cherry-pick b2c3d4e

1
2
3
4
5
6

# リポジトリのサイズを確認
$ du -sh .git
500M    .git

# 大きなファイルを特定（Git 2.18以降）
$ git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | sed -n 's/^blob //p' | sort -rnk2 | head -10

1
2
3
4
5
6

# 直前のコミットの場合
git reset --soft HEAD~1
git restore --staged large-file.zip
echo "large-file.zip" >> .gitignore
git add .gitignore
git commit -m "feat: 機能実装（大きなファイルを除外）"

1
2
3
4
5
6
7
8

# filter-branchで履歴から削除（非推奨だが動作する）
git filter-branch --force --index-filter \
  'git rm --cached --ignore-unmatch large-file.zip' \
  --prune-empty --tag-name-filter cat -- --all

# ガベージコレクションでサイズを削減
git reflog expire --expire=now --all
git gc --prune=now --aggressive

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# インストール（pip経由）
pip install git-filter-repo

# 大きなファイルを履歴から削除
git filter-repo --path large-file.zip --invert-paths

# 複数ファイルを削除
git filter-repo --path file1.zip --path file2.mp4 --invert-paths

# パターンで削除
git filter-repo --path-glob '*.zip' --invert-paths

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# BFGをダウンロードして実行
# https://rtyley.github.io/bfg-repo-cleaner/

# 100MB以上のファイルを削除
java -jar bfg.jar --strip-blobs-bigger-than 100M

# 特定のファイルを削除
java -jar bfg.jar --delete-files large-file.zip

# クリーンアップ
git reflog expire --expire=now --all
git gc --prune=now --aggressive

1
2
3
4
5

# すべてのブランチを強制プッシュ
git push --force-with-lease --all origin

# タグも更新
git push --force-with-lease --tags origin

1
2
3
4
5
6
7

# .gitignoreに追加
*.zip
*.tar.gz
*.mp4
*.mov
node_modules/
vendor/

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# .git/hooks/pre-commit
#!/bin/bash

# 10MB以上のファイルをブロック
max_size=10485760

for file in $(git diff --cached --name-only); do
  if [ -f "$file" ]; then
    size=$(wc -c < "$file")
    if [ "$size" -gt "$max_size" ]; then
      echo "Error: $file is larger than 10MB"
      exit 1
    fi
  fi
done

1
2
3
4

# 現在の状態を確認
git status
git branch -v
git log --oneline -5

1
2
3
4
5
6

# リモートの最新情報を取得
git fetch origin

# ローカルとリモートの差分を確認
git log origin/main..HEAD --oneline  # ローカルにあってリモートにない
git log HEAD..origin/main --oneline  # リモートにあってローカルにない

1
2
3
4
5

# 現在の状態でバックアップブランチを作成
git branch backup-$(date +%Y%m%d-%H%M%S)

# reflogで操作履歴を確認
git reflog

1
2
3
4
5
6

# 状態を確認
git status
git log --oneline -5

# 問題が解決したらバックアップブランチを削除
git branch -d backup-20260102-120000