git fetchとgit pullの違いを出力で見比べる方法

​​Git​コマンドライン

git fetch はリモートの新しいコミットを origin/main などのリモート追跡ブランチに取ってくるだけで、手元の main も作業中のファイルも変えません。git pull は同じ取得をしたあと、続けて手元の main に取り込みます。チーム開発で、他の人が push した変更を、取り込む前に確かめたいときは git fetch を使います。ここでは、同じ状態の2つのクローンで git fetch と git pull を打ち、前と後の出力を並べます。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定し、出力が毎回同じになるよう、コミットの日時を環境変数で固定しました。リモートは同じ検証環境の中に作ったリポジトリで、手元のクローンからは相対パス ../remote.git で指しています。出力の From の行には、末尾の .git を省いた ../remote が表示されます。GitHub などのホスティングサービス、Windows・macOS は試していません。手元とリモートの両方に別のコミットがある場合も、この記事の検証には含めていません。

試した状態

index.html だけのリポジトリを、同じ時点で2つクローンしました。そのあと、別のクローンから、main に about.html を足すコミットと、新しいブランチ dark-mode を push しました。この2つのクローンの片方で git fetch を、もう片方で git pull を試します。

2つのクローンは、この時点ではまだリモートの変更を何も知りません。どちらでも git status は、origin/main と同じ(up to date)と表示します。

console
$ git status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

$ git branch -a
* main
  remotes/origin/HEAD -> origin/main
  remotes/origin/main

$ git log --oneline --decorate --graph --all
* ea95d47 (HEAD -> main, origin/main, origin/HEAD) 最初のコミット

$ ls
index.html

Your branch is up to date with 'origin/main'. は、手元にある origin/main と比べた結果です。リモートにはすでに新しいコミットがありますが、取得するまではここに出てきません。

取得する前、git fetch のあと、git pull のあとの3つの状態を縦に並べた図。fetch のあとは main と origin/main のうち origin/main だけが fa1a6fe に進み、main は ea95d47 のままで、作業中のファイルは index.html だけ。pull のあとは main も fa1a6fe に追いつき、about.html が増えている
main・origin/main の指すコミットと作業中のファイルが、fetch と pull でどう変わるか

git fetch の出力と、そのあとの状態

git fetch の出力は次のとおりです。

console
$ git fetch
From ../remote
   ea95d47..fa1a6fe  main       -> origin/main
 * [new branch]      dark-mode  -> origin/dark-mode

1行が1つのブランチに対応しています。main -> origin/main は、リモートの main を手元の origin/main に取ってきたという意味で、ea95d47..fa1a6fe は origin/main が指すコミットの前と後です。先頭の * は新しく取ってきたブランチを表します。git fetch の公式リファレンスにある出力の説明によると、この 前..後 の部分は、そのまま git log に渡せる形になっています。

取得したあと、git status の表示が変わります。

console
$ git status
On branch main
Your branch is behind 'origin/main' by 1 commit, and can be fast-forwarded.
  (use "git pull" to update your local branch)

nothing to commit, working tree clean

手元の main が origin/main より1コミット遅れていて、早送り(fast-forward)で追いつけると分かります。ブランチの一覧、履歴、ファイルを見ると、動いたのはリモート追跡ブランチだけです。

console
$ git branch -a
* main
  remotes/origin/HEAD -> origin/main
  remotes/origin/dark-mode
  remotes/origin/main

$ git log --oneline --decorate --graph --all
* 33ee204 (origin/dark-mode) ダークモードの色を足す
* fa1a6fe (origin/main, origin/HEAD) 紹介ページを足す
* ea95d47 (HEAD -> main) 最初のコミット

$ ls
index.html

main は ea95d47 のままで、about.html もまだありません。新しいブランチも remotes/origin/dark-mode として増えただけで、手元のブランチ dark-mode は作られていません。

git fetch の公式リファレンスの説明にあるとおり、取ってきたブランチの名前と、それが指すコミットは .git/FETCH_HEAD にも書かれます。

console
$ cat .git/FETCH_HEAD
fa1a6fe885ed6be0e01720b70055a06b0516c3af		branch 'main' of ../remote
33ee20484daaf8b9f333133f06c69b7eeaacd57b	not-for-merge	branch 'dark-mode' of ../remote

取り込む前に、取ってきた変更を確かめる

git fetch のあとなら、手元のファイルを変えないまま、リモートで何が変わったかを見られます。main..origin/main は、公式リファレンスにある範囲の書き方のとおり、「origin/main からたどれて、main からはたどれないコミット」を指します。

console
$ git log --oneline main..origin/main
fa1a6fe 紹介ページを足す

$ git diff --stat main origin/main
 about.html | 1 +
 1 file changed, 1 insertion(+)

$ git log --oneline -p -1 origin/main
fa1a6fe 紹介ページを足す
diff --git a/about.html b/about.html
new file mode 100644
index 0000000..0d799f0
--- /dev/null
+++ b/about.html
@@ -0,0 +1 @@
+<h1>このブログについて</h1>

内容に問題がなければ、git merge origin/main で取り込みます。

console
$ git merge origin/main
Updating ea95d47..fa1a6fe
Fast-forward
 about.html | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 about.html

$ git status
On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

$ ls
about.html
index.html

ここで初めて main が進み、about.html が作業中のフォルダに現れました。

git pull の出力は、fetch と merge をつなげたもの

もう片方のクローン(取得する前の状態は同じ)で git pull を打ちました。

console
$ git pull
From ../remote
   ea95d47..fa1a6fe  main       -> origin/main
 * [new branch]      dark-mode  -> origin/dark-mode
Updating ea95d47..fa1a6fe
Fast-forward
 about.html | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 about.html

前半の3行は git fetch の出力と同じで、Updating からあとは git merge origin/main の出力と同じです。git pull の公式リファレンスにも、git pull は git fetch を実行してから、設定やオプションに応じて git rebase か git merge を呼ぶと書かれています。

そのあとの履歴とファイルも、git fetch と git merge を続けて打ったクローンと同じでした。

console
$ git log --oneline --decorate --graph --all
* 33ee204 (origin/dark-mode) ダークモードの色を足す
* fa1a6fe (HEAD -> main, origin/main, origin/HEAD) 紹介ページを足す
* ea95d47 最初のコミット

$ ls
about.html
index.html

git pull でも、dark-mode は origin/dark-mode として取ってくるだけで、手元のブランチは作られませんでした。取り込まれるのは今いるブランチ(ここでは main)だけです。

違ったのは、git reflog に残る操作の名前だけです。git fetch のあとに git merge origin/main したクローンでは、次のとおりです。

console
$ git reflog -1
fa1a6fe HEAD@{0}: merge origin/main: Fast-forward

git pull したクローンでは、次のとおりです。

console
$ git reflog -1
fa1a6fe HEAD@{0}: pull: Fast-forward

新しいものがないときの表示

取ってきたあと、取り込む前にもう一度 git fetch を打つと、何も表示せずに終わり、終了コードは 0 でした。取り込んだあとにもう一度 git pull を打つと、Already up to date. と表示します。

console
$ git fetch; echo "exit=$?"
exit=0
console
$ git pull
Already up to date.

git fetch の出力が空なのは、変わったブランチがなかったからです。公式リファレンスの出力の説明にあるとおり、更新のなかったブランチは --verbose を付けたときだけ表示されます。

今回は手元の main に、まだ push していないコミットがなかったので、git pull も git merge も早送りで済みました。手元とリモートの両方に別のコミットがあると、Git 2.43.0 の git pull は取り込み方(マージかリベースか)を指定するよう求めて止まります。その場合の直し方は、このブログの記事「git pullのdivergent branchesエラーを直す方法」で、実際の出力とあわせて説明しています。

​Posted by 86