fetch と pull — 2台で作業するとき

git fetch — GitHub の様子を見に行く

1. もう1台の Mac で「パンを追加」をコミットして push しました。上の GitHub 側の main が1つ進みます。画面のターミナルは Windows のノート PC で、こちらにはまだ何も届いていません。

2. git status は up to date（最新です）と答えます。これは GitHub に問い合わせた結果ではなく、手元に貼ってある origin/main の付箋と比べた結果です。origin/main は前に確かめたときのまま、卵を追加 に貼ってあります。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   nothing to commit, working tree clean

3. git fetch は GitHub の様子を見に行き、手元に無いコミットを取ってきて、origin/main の付箋だけを進めます。c43e6a8..9ae3d51 main -> origin/main は「GitHub の main を写して、手元の origin/main を c43e6a8 から 9ae3d51 へ進めた」という意味です。HEAD と main は動いていません。

   $ git fetch
   From https://github.com/you/memo-app
      c43e6a8..9ae3d51  main       -> origin/main

4. 同じ git status が、今度は behind 'origin/main' by 1 commit（origin/main より1つ遅れている）と答えます。can be fast-forwarded は「付箋を前に進めるだけで追いつける」という意味です。

   $ 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

5. --all を付けると、手元にあるすべての付箋が見えます。origin/main は パンを追加 に、HEAD -> main は 卵を追加 に貼ってあります。origin/HEAD は GitHub 側の既定のブランチを指す札で、ここでは気にしなくて構いません。

   $ git log --oneline --all
   9ae3d51 (origin/main, origin/HEAD) パンを追加
   c43e6a8 (HEAD -> main) 卵を追加
   3f2a9c1 牛乳を追加

6. 作業ツリーの todo.txt は2行のままです。fetch は手元の main にも作業ツリーにも触らないので、書きかけがあっても、いつ打っても安全です。

   $ cat todo.txt
   牛乳を買う
   卵を買う

7. もう一度 fetch すると、何も出ません。GitHub 側に新しいコミットが無いとき、fetch は黙って終わります。

   $ git fetch

git pull --ff-only — 手元の main を追いつかせる

1. Mac が push した直後の、fetch する前の状態から始めます。GitHub 側には パンを追加 があり、手元の todo.txt はまだ2行です。この動画では、下に作業ツリー・ステージ・HEAD のコミットの中身も出しています。

   $ cat todo.txt
   牛乳を買う
   卵を買う

2. 出力は2つに分かれます。前半の From … の2行は fetch と同じで、origin/main を進めます。後半の Updating c43e6a8..9ae3d51 と Fast-forward は、手元の main を origin/main の位置まで前に進めたという意味で、作業ツリーの中身も入れ替わります。

   $ git pull --ff-only
   From https://github.com/you/memo-app
      c43e6a8..9ae3d51  main       -> origin/main
   Updating c43e6a8..9ae3d51
   Fast-forward
    todo.txt | 1 +
    1 file changed, 1 insertion(+)

3. todo.txt に「パンを買う」が入りました。Mac で書いた1行が、Windows のノート PC に届いたことになります。

   $ cat todo.txt
   牛乳を買う
   卵を買う
   パンを買う

4. HEAD -> main と origin/main が、同じ パンを追加 に並びました。新しいコミットは作られておらず、付箋が前に進んだだけです。これが fast-forward（早送り）です。

   $ git log --oneline --all
   9ae3d51 (HEAD -> main, origin/main, origin/HEAD) パンを追加
   c43e6a8 卵を追加
   3f2a9c1 牛乳を追加

5. up to date に戻りました。今度は、origin/main を GitHub に合わせたうえでの「最新」です。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   nothing to commit, working tree clean

6. 追いついたあとにもう一度打つと、Already up to date.（もう最新です）とだけ出て、何も変わりません。

   $ git pull --ff-only
   Already up to date.

2台で別々にコミットしたとき — diverged

1. Windows のノート PC で、GitHub の様子を確かめずに作業を始めます。todo.txt に1行書き足します。

   $ echo "バターを買う" >> todo.txt

2. 手元の main が バターを追加 に進みました。まだ push していないので、GitHub 側は 卵を追加 のままです。

   $ git commit -am "バターを追加"
   [main 15e1410] バターを追加
    1 file changed, 1 insertion(+)

3. 同じころ、Mac でも別のコミット メモを追加 を作って push しました。GitHub 側の main は、卵を追加 から手元とは別の方向へ進みます。同じ親から2本に分かれた、枝分かれの状態です。

4. ahead of 'origin/main' by 1 commit（1つ先に進んでいる）としか出ません。手元の origin/main はまだ 卵を追加 にあり、Mac の push を知らないからです。

   $ 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

5. push は拒否されます。(fetch first) は「GitHub 側に、手元に無いコミットがある。先に fetch して」という意味です。GitHub 側の メモを追加 を消してしまわないように、Git が止めています。

   $ git push
   To https://github.com/you/memo-app.git
    ! [rejected]        main -> main (fetch first)
   error: failed to push some refs to 'https://github.com/you/memo-app.git'
   hint: Updates were rejected because the remote contains work that you do not
   hint: have locally. This is usually caused by another repository pushing to
   hint: the same ref. If you want to integrate the remote changes, use
   hint: 'git pull' before pushing again.
   hint: See the 'Note about fast-forwards' in 'git push --help' for details.

6. fetch すると メモを追加 が手元に届き、origin/main がそこへ進みます。下の手元のグラフでも、卵を追加 から2本に分かれたのが見えるようになりました。

   $ git fetch
   From https://github.com/you/memo-app
      c43e6a8..9ae3d51  main       -> origin/main

7. have diverged（枝分かれした）と出ます。have 1 and 1 different commits each は「手元の main にだけあるコミットが1つ、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

8. git branch -vv は、ブランチごとの上流と差を1行で見せます。[origin/main: ahead 1, behind 1] は「上流は origin/main で、1つ先に進み、1つ遅れている」という意味です。

   $ git branch -vv
   * main 15e1410 [origin/main: ahead 1, behind 1] バターを追加

9. --ff-only は、付箋を前に進めるだけで済むときにしか動きません。枝分かれしていると Not possible to fast-forward, aborting.（早送りできないので中止します）と止まり、手元の main も作業ツリーも何も変えません。hint にある git merge と git rebase が2本をつなぐ方法で、第3部で扱います。

   $ git pull --ff-only
   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 set advice.diverging false"
   fatal: Not possible to fast-forward, aborting.

10. push も、今度は (non-fast-forward) で拒否されます。手元の main は GitHub 側の メモを追加 を含んでいないので、そのまま送ると メモを追加 が GitHub から消えてしまうからです。2本をつないでからでないと push できません。

    $ git push
    To https://github.com/you/memo-app.git
     ! [rejected]        main -> main (non-fast-forward)
    error: failed to push some refs to 'https://github.com/you/memo-app.git'
    hint: Updates were rejected because the tip of your current branch is behind
    hint: its remote counterpart. If you want to integrate the remote changes,
    hint: use 'git pull' before pushing again.
    hint: See the 'Note about fast-forwards' in 'git push --help' for details.

作業を始める前の習慣 — fetch・status・pull --ff-only

1. 昨夜 Mac で push した分が、GitHub 側にあります。作業を始める前に、まず git fetch -q で GitHub の様子を見に行きます。-q（quiet＝静かに）は出力を消すだけで、origin/main の付箋はちゃんと進んでいます。

   $ git fetch -q

2. 次に git status で、origin/main との差を見ます。behind で can be fast-forwarded なら、Mac で進めた分を取り込むだけで済みます。

   $ 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

3. git pull --ff-only で、手元の main を origin/main まで進めます。fetch は済んでいるので、出力は Updating から始まります。

   $ git pull --ff-only
   Updating c43e6a8..9ae3d51
   Fast-forward
    todo.txt | 1 +
    1 file changed, 1 insertion(+)

4. これで、GitHub と同じところから作業を始められます。

   $ echo "バターを買う" >> todo.txt

5. コミットすると、手元の main が origin/main の1つ先に進みます。

   $ git commit -am "バターを追加"
   [main 5f2309f] バターを追加
    1 file changed, 1 insertion(+)

6. ahead of 'origin/main' by 1 commit で、手元にだけコミットが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

7. push は拒否されずに通ります。GitHub 側の main と手元の origin/main が、そろって バターを追加 へ進みます。

   $ git push
   To https://github.com/you/memo-app.git
      9ae3d51..5f2309f  main -> main

8. up to date です。次に Mac で作業を始めるときも、fetch → status → pull --ff-only から始めれば、2台が枝分かれしません。

   $ git status
   On branch main
   Your branch is up to date with 'origin/main'.
   
   nothing to commit, working tree clean