git fetchとgit pullの違いを出力で見比べる方法
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)と表示します。
$ 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 fetch の出力は次のとおりです。
$ 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 の表示が変わります。
$ 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)で追いつけると分かります。ブランチの一覧、履歴、ファイルを見ると、動いたのはリモート追跡ブランチだけです。
$ 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 にも書かれます。
$ 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 からはたどれないコミット」を指します。
$ 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 で取り込みます。
$ 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 を打ちました。
$ 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 を続けて打ったクローンと同じでした。
$ 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 したクローンでは、次のとおりです。
$ git reflog -1
fa1a6fe HEAD@{0}: merge origin/main: Fast-forward
git pull したクローンでは、次のとおりです。
$ git reflog -1
fa1a6fe HEAD@{0}: pull: Fast-forward
新しいものがないときの表示
取ってきたあと、取り込む前にもう一度 git fetch を打つと、何も表示せずに終わり、終了コードは 0 でした。取り込んだあとにもう一度 git pull を打つと、Already up to date. と表示します。
$ git fetch; echo "exit=$?"
exit=0
$ 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エラーを直す方法」で、実際の出力とあわせて説明しています。





