【Git】「refusing to merge unrelated histories」エラーの原因と対処法｜allow-unrelated-histories・再clone・subtreeの使い分け

$ git pull origin main
fatal: refusing to merge unrelated histories

# 通常のマージ: 共通祖先 C を基準に変更を合成
#        A1 - A2 - A3   ← mainブランチ
#       /
#   C -
#       \
#        B1 - B2        ← feature/xxx
# → merge-base = C

# unrelated histories: 共通祖先が無い
#   A1 - A2 - A3   ← ローカル main
#   B1 - B2 - B3   ← リモート main
# → merge-base が無い → refusing to merge

# 両ブランチの履歴を図で見る
git fetch --all
git log --oneline --all --graph --decorate -30

# 共通祖先の直接確認
git merge-base HEAD origin/main
# → 共通祖先のSHAが出れば「関係あり」
# → fatal: Not a valid object name / 結果なしなら「unrelated」確定

# ブランチごとの最古コミットを確認
git log --oneline --reverse HEAD | head -1
git log --oneline --reverse origin/main | head -1
# 初期コミットのSHAが完全に違っていたら unrelated

# pullで一気に取り込む（内部的にはfetch＋merge）
git pull origin main --allow-unrelated-histories

# fetch と merge を分けて段階的に
git fetch origin main
git merge origin/main --allow-unrelated-histories

# rebase で取り込みたい場合
git pull --rebase origin main
# ※ rebase系ではこのフラグは不要（内部的に単にコミットを並べる）

# コンフリクトが起きたら通常通り解決
git add .
git commit

# 状況：GitHubでREADME付きリポを作成
# ローカルでも git init してコミット済み

# GitHub側のREADMEと統合する
git remote add origin https://github.com/USER/REPO.git
git pull origin main --allow-unrelated-histories

# コンフリクト解消（READMEが両方にあれば）
# 手動でファイル編集 → add → commit

# push
git push -u origin main

# ローカルの作業を念のため退避
cp -r your-project your-project.backup

# 既存ローカルを削除
rm -rf your-project

# 改めてclone
git clone https://github.com/USER/REPO.git your-project
cd your-project

# ローカルの変更が必要ならbackupからコピー
cp -r ../your-project.backup/src/* src/
git add .
git commit -m "feat: ローカル作業を取り込み"
git push

# 他プロジェクトを sub-project/ ディレクトリとして取り込み
git remote add -f other-repo https://github.com/USER/OTHER.git
git subtree add --prefix=sub-project other-repo main --squash

# subtreeの更新取り込み
git subtree pull --prefix=sub-project other-repo main --squash

# subtreeから他リポへの送信
git subtree push --prefix=sub-project other-repo main

# サブモジュールとして追加
git submodule add https://github.com/USER/OTHER.git sub-project
git commit -m "feat: sub-project を submodule として追加"
git push

# クローン時
git clone --recurse-submodules https://github.com/USER/REPO.git
# 後から初期化する場合
git submodule update --init --recursive

# 相手のリポを remote として追加
git remote add other https://github.com/USER/OTHER.git
git fetch other

# 取り込みたいコミットの範囲を確認
git log --oneline other/main -20

# 単一コミットを持ってくる
git cherry-pick <SHA>

# 複数コミットを順番に
git cherry-pick <SHA1> <SHA2> <SHA3>

# 範囲指定
git cherry-pick <古いSHA>..<新しいSHA>

# コンフリクト時は通常通り解決
git add .
git cherry-pick --continue

# マージコミットを作らず、相手の変更を自分の次のコミットに押し込む
git merge --squash origin/main --allow-unrelated-histories
git commit -m "feat: 他リポの内容を取り込み（squash）"

# pull時にsquash
git pull --squash origin main --allow-unrelated-histories

# 現状確認
git log --oneline --all --graph
# → ローカルとorigin/mainが平行に並んでいる

# 統合
git pull origin main --allow-unrelated-histories

# README重複でconflict
# どちらを採用するか決めて編集 → add → commit

git push -u origin main

# 統合先（メインリポ）
cd main-repo
git remote add sub ../sub-repo
git fetch sub

# 統合（履歴も残す）
git merge sub/main --allow-unrelated-histories

# ファイル衝突があれば解消
git add .
git commit

# 整理後 push
git push

# 正しいリモートに変更
git remote set-url origin https://github.com/USER/CORRECT_REPO.git
git remote -v

# 改めてpull（正しい履歴なら unrelated にならない）
git pull origin main

# filter-repoでmainを書き換え後、push --force で反映
git push --force-with-lease origin main

# 他メンバーは再cloneが安全
# （無理にpullするとunrelatedエラー）
rm -rf your-project
git clone https://github.com/USER/REPO.git

# 1. GitHubで空リポ作成（READMEチェックなし）
# 2. ローカルで初期化してpush
cd your-project
git init
git branch -M main
git add .
git commit -m "feat: initial commit"
git remote add origin https://github.com/USER/REPO.git
git push -u origin main
# → unrelated historiesエラーが発生しない