git pullのdivergent branchesエラーを直す方法
git pull を実行して fatal: Need to specify how to reconcile divergent branches. と表示されて止まったときは、取り込み方を指定してもう一度 git pull すれば進みます。マージでつなぐなら git pull --no-rebase、自分のコミットを相手のコミットの後ろに積み直すなら git pull --rebase です。チーム開発で、同じブランチに別の人(または別のパソコンの自分)が先に push していて、手元にも push していないコミットがあるときに出るエラーです。以下では、エラーが出るまでと、それぞれの直し方の前後について、検証環境で実際にコマンドを打ったときの出力をそのまま載せます。
検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定し、出力が毎回同じになるよう、コミットの日時を環境変数で決めました。リモートは同じ検証環境の中に作ったリポジトリで、手元のクローンからは相対パス ../remote.git で指しています。そのため、出力の From の行やマージコミットのメッセージには ../remote、To の行には ../remote.git と表示されています。GitHub などのホスティングサービス、Windows・macOS、pull.rebase の merges や interactive の値、競合を解決したあとの git rebase --continue は試していません。
エラーが出るまで
index.html だけのリポジトリを、2つのクローン(手元と、別の作業場所)から使います。別の作業場所で紹介ページ about.html を足して push したあと、手元ではそれを取り込まないまま、フッターの年を直すコミットを作りました。
この時点の手元の git status は、リモートの変更をまだ知らないので、自分のコミットが1つ多いとだけ表示します。
$ git status
On branch main
Your branch is ahead of 'origin/main' by 1 commit.
(use "git push" to publish your local commits)
nothing to commit, working tree clean
ここで git pull を実行すると、次のように止まります。
$ git pull; echo "exit=$?"
From ../remote
59e6605..7da19de main -> origin/main
hint: You have divergent branches and need to specify how to reconcile them.
hint: You can do so by running one of the following commands sometime before
hint: your next pull:
hint:
hint: git config pull.rebase false # merge
hint: git config pull.rebase true # rebase
hint: git config pull.ff only # fast-forward only
hint:
hint: You can replace "git config" with "git config --global" to set a default
hint: preference for all repositories. You can also pass --rebase, --no-rebase,
hint: or --ff-only on the command line to override the configured default per
hint: invocation.
fatal: Need to specify how to reconcile divergent branches.
exit=128
最初の2行のとおり、リモートの最新のコミット(7da19de)の取得までは済んでいます。止まったのは、そのあとの手元のブランチに取り込む段階です。git status と履歴を見ると、手元の main と origin/main が、それぞれ別のコミットを1つずつ持っていることが分かります。
$ git status
On branch main
Your branch and 'origin/main' have diverged,
and have 1 and 1 different commits each, respectively.
(use "git pull" if you want to integrate the remote branch with yours)
nothing to commit, working tree clean
$ git log --graph --oneline --all
* 398550a フッターの年を直す
| * 7da19de 紹介ページを足す
|/
* 59e6605 最初のコミット
$ ls
index.html
手元の作業ツリーには about.html がまだなく、手元のコミットも消えていません。エラーで止まっても手元は何も変わっていないので、このあと取り込み方を選んでやり直せます。
Git 2.43 の git pull の公式リファレンスには、手元のブランチがリモートより古いだけなら早送り(fast-forward)で進め、両方が分かれているときは --rebase か --no-rebase(または設定の pull.rebase)でどう合わせるかを指定する必要がある、と書かれています。
マージとリベースの違い
取り込み方は、主にマージとリベースの2つです。下の図は、このあと実際に打った結果の履歴を並べたものです。

マージは、元のコミットをそのまま残し、2つをつなぐマージコミットを1つ増やします。リベースは、手元のコミットをリモートのコミットの後ろに作り直して、履歴を一本にします。作り直すので、手元のコミットのハッシュが変わります。
git pull –no-rebase でマージする
$ git pull --no-rebase --no-edit
Merge made by the 'ort' strategy.
about.html | 1 +
1 file changed, 1 insertion(+)
create mode 100644 about.html
$ git log --graph --oneline --all
* 9a1a6c6 Merge branch 'main' of ../remote
|\
| * 7da19de 紹介ページを足す
* | 398550a フッターの年を直す
|/
* 59e6605 最初のコミット
$ ls
about.html
index.html
--no-edit は、Git が自動で作ったマージコミットのメッセージ(ここでは Merge branch 'main' of ../remote)を、エディターで編集せずにそのまま使うためのオプションです。検証ではエディターを開かずに進めるために付けましたが、公式リファレンスの –edit と –no-edit の説明では、メッセージを書き足して、なぜマージしたのかを残すほうが勧められています。about.html が取り込まれ、手元の 398550a もそのまま残りました。
取り込んだあとで、やはりやめたいときは、git reset --hard ORIG_HEAD で git pull の前に戻せます。git reset の公式リファレンスの例にあるとおり、git pull は取り込む前のブランチの先頭を ORIG_HEAD に残すためです。検証では、次の手順を試すためにこの方法で戻しました。ただし --hard は、Git が追跡しているファイルの、コミットしていない変更を消します。作業ツリーに変更が残っていないときだけ使ってください。
$ git reset -q --hard ORIG_HEAD
$ git log --graph --oneline --all
* 398550a フッターの年を直す
| * 7da19de 紹介ページを足す
|/
* 59e6605 最初のコミット
git pull –rebase で一本の履歴にする
同じ状態から、今度は --rebase で取り込みます。
$ git pull --rebase
Successfully rebased and updated refs/heads/main.
$ git log --graph --oneline --all
* e6a925e フッターの年を直す
* 7da19de 紹介ページを足す
* 59e6605 最初のコミット
実際の出力では、Successfully rebased... の行の前に、進み具合を示す Rebasing (1/1) があります。そのあとに行の先頭に戻る制御文字と行を消す制御文字が続くので、ここでは Successfully rebased... の行だけを載せています(このあとの git pull と git pull --rebase の出力でも、同じように Rebasing (1/1) を省いています)。マージコミットはできず、「フッターの年を直す」が「紹介ページを足す」の後ろに来ています。ハッシュは 398550a から e6a925e に変わりました。
git pull の公式リファレンスにある –rebase の説明では、リベースは履歴を書き換えるので、すでに公開した履歴に使うのは危険だと注意されています。この検証で作り直された 398550a は、まだどこにも push していないコミットでした。
分かれたままなら止める –ff-only
リベースの前の状態に、もう一度 git reset --hard ORIG_HEAD で戻してから試しました。--ff-only を付けると、早送りで済むときだけ取り込み、分かれているときは、手元のブランチを変えずに止まります。
$ git pull --ff-only; echo "exit=$?"
hint: Diverging branches can't be fast-forwarded, you need to either:
hint:
hint: git merge --no-ff
hint:
hint: or:
hint:
hint: git rebase
hint:
hint: Disable this message with "git config advice.diverging false"
fatal: Not possible to fast-forward, aborting.
exit=128
$ git log --oneline -1
398550a フッターの年を直す
これだけでは直りません。手元のブランチは 398550a のまま変わっていないので、ここからマージかリベースかを選びます。
毎回の指定を設定で省く
エラーの hint にあったとおり、pull.rebase を設定しておけば、git pull だけでその取り込み方になります。true ならリベース、false ならマージです。ここではリベースにしました。
$ git config pull.rebase true
$ git config --show-origin pull.rebase
file:.git/config true
$ git pull
Successfully rebased and updated refs/heads/main.
$ git log --graph --oneline --all
* 2491ad5 フッターの年を直す
* 7da19de 紹介ページを足す
* 59e6605 最初のコミット
$ git push origin main
To ../remote.git
7da19de..2491ad5 main -> main
--global を付けずに設定したので、git config --show-origin で確かめると、このリポジトリの .git/config に書かれていました。すべてのリポジトリで同じにしたいときは、hint にあるとおり git config --global pull.rebase true のように --global を付けます。取り込んだあとの git push は、そのまま通りました。設定の意味は、git config の公式リファレンスにある pull.rebase の説明にもあります。
なお、push していないコミットがなく、リモートより古いだけのクローンでは、何も指定しなくてもエラーにならず、早送りで取り込まれます。別の作業場所のクローンで git pull すると、次のようになりました。
$ git pull
From ../remote
7da19de..2491ad5 main -> origin/main
Updating 7da19de..2491ad5
Fast-forward
index.html | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
git pull –rebase で競合したときにやめる
両方のクローンで同じ行を変えて試したところ、git pull --rebase は競合で止まりました。別の作業場所でフッターを © 2026 ねこノート に変えて push し、手元ではフッターを 2026 ねこノート編集部 に変えてから、git pull --rebase を実行しています。
$ git pull --rebase; echo "exit=$?"
From ../remote
2491ad5..6e86eeb main -> origin/main
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
error: could not apply 9563e48... フッターに編集部を足す
hint: Resolve all conflicts manually, mark them as resolved with
hint: "git add/rm <conflicted_files>", then run "git rebase --continue".
hint: You can instead skip this commit: run "git rebase --skip".
hint: To abort and get back to the state before "git rebase", run "git rebase --abort".
Could not apply 9563e48... フッターに編集部を足す
exit=1
$ cat index.html
<h1>ねこノート</h1>
<p>毎週金曜に更新します</p>
<<<<<<< HEAD
<footer>© 2026 ねこノート</footer>
=======
<footer>2026 ねこノート編集部</footer>
>>>>>>> 9563e48 (フッターに編集部を足す)
<<<<<<< HEAD の側に入っているのは、リモートの内容(© 2026 ねこノート)です。リベースでは、リモートのコミットの上に自分のコミットを積み直している途中なので、HEAD はリモート側を指しています。手元で書いた内容は、>>>>>>> の側にあります。git checkout の公式リファレンスにある –ours の説明でも、git pull --rebase の途中では、競合したファイルでどちらの内容を使うかを選ぶ --ours(自分の側)と --theirs(相手の側)が入れ替わって見えることがあり、--ours はリベースの土台になるブランチの側だと書かれています。
hint には、競合を直して git add し、git rebase --continue を実行するよう表示されています。リベースをやめて git pull の前に戻すなら、git rebase --abort です。
$ git rebase --abort
$ git status
On branch main
Your branch and 'origin/main' have diverged,
and have 1 and 1 different commits each, respectively.
(use "git pull" if you want to integrate the remote branch with yours)
nothing to commit, working tree clean
$ cat index.html
<h1>ねこノート</h1>
<p>毎週金曜に更新します</p>
<footer>2026 ねこノート編集部</footer>
手元のファイルとコミット(9563e48)は元のままで、git status は、最初のエラーのときと同じ「分かれている」状態に戻りました。




