git pull

実行前の状態

自分が README.md を 1 回コミットして送ったあと、ほかの人が先にコミットを 1 つ送った場面です。リモートにだけ新しいコミットがあり、それを手元に取り込みたいときに打ちます。

この状態を手元で作るなら、次の順に打ちます。リモートは手元に作った受け皿 (origin.git) で、ほかの人は別のフォルダ (friend) で見立てます。

git init -q --bare -b main origin.git
git init -q -b main hello
cd hello
echo "# hello" > README.md
git add README.md
git commit -q -m "README を作る"
git remote add origin ../origin.git
git push -q -u origin main
cd ..
git clone -q origin.git friend
cd friend
echo "friend" > friend.txt
git add friend.txt
git commit -q -m "friend.txt を足す"
git push -q
cd ../hello

最小の例と結果

git pull

From ../origin
   a1b2c3d..9f8e7d6  main       -> origin/main
Updating a1b2c3d..9f8e7d6
Fast-forward
 friend.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 friend.txt

• From ../origin は取り込み元です。
• main -> origin/main は、リモートの main の新しい分を、手元にある origin/main (リモートの様子の控え) へ写したという意味です。
• Fast-forward は、手元に別のコミットが無かったので、ブランチをそのまま前へ進めたという意味です。
• friend.txt | 1 + は、取り込んだコミットで足された物です。

成功の確認

履歴の一番上に、取り込んだコミットがあれば入っています。

git log --oneline

9f8e7d6 friend.txt を足す
a1b2c3d README を作る

git status -sb

## main...origin/main

git status -sb の 1 行目に [behind 1] が出ていなければ、リモートに追いついています。

構文と主要オプション

git pull は、リモートの新しい分を取りに行く git fetch と、手元へまとめる git merge を続けて打つコマンドです。--rebase を付けたときや、pull.rebase の設定が有効なときは、git merge の代わりに git rebase が走ります。取り込む前に中身を見たいときは、git fetch だけを打ちます。

失敗時の戻し方

pull は、手元のブランチを動かします。取り込む前の位置は ORIG_HEAD という名前で残るので、取り込みを取り消したいときはそこへ戻します。

git reset --hard ORIG_HEAD

--hard は、作業中のファイルの変更まで消します。pull の前に、変更をコミットしてあるか、git status で変更が無いことを確かめてから打ちます。

衝突が出たとき

取り込みの途中で衝突すると、pull は途中で止まります。衝突したファイルを直して git add し、merge で取り込んでいるなら git commit で終わらせます。--rebase で取り込んでいるなら、git rebase --continue で続けます。やめたいときは、取り込む前の状態に戻します。

git merge --abort

git pull --rebase で衝突したときは、代わりに git rebase --abort を使います。

よくある疑問

関連

• push と pull で同期する受講生向けのレッスン
• clone と fetch の違い受講生向けのレッスン
• クラウドエディター受講生向けの、ブラウザで開く開発環境
• git push 手元のコミットを送る
• git merge 2 つの履歴をまとめる
• git rebase コミットを付け替える