git push — 手元のコミットを GitHub に送る

git push — コミットを送ると2枚の札が動く

1. 出発点です。上の GitHub 側の main も、下の手元の main も「卵を追加」に貼ってあります。手元の点線の札 origin/main は、GitHub の main の位置を手元に写した 追跡ブランチ です。

2. todo.txt に「パンを買う」を書き足して、コミットします。

   $ echo "パンを買う" >> todo.txt

3. 進んだのは手元の main だけです。GitHub 側の図は何も変わっていません。コミットは、push するまで手元のパソコンの中にしかありません。

   $ git commit -am "パンを追加"
   [main c43e6a8] パンを追加
    1 file changed, 1 insertion(+)

4. ahead of 'origin/main' by 1 commit は「GitHub の写し（origin/main）より1つ先に進んでいる」という意味です。次の行で Git が、送るなら git 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. (HEAD -> main) と (origin/main, origin/HEAD) が別の行に付いています（origin/HEAD は GitHub の既定のブランチを指す写しで、2-1 で見ました）。origin/main の行より上にあるコミットが、push で送られるものです。

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

6. git push は手元のコミットを GitHub に送り、GitHub 側の main と手元の origin/main を一緒に進めます（手元の main は動きません）。8b41d07..c43e6a8 main -> main は「手元の main を GitHub の main へ送り、8b41d07 から c43e6a8 まで進めた」と読みます。

   $ git push
   To https://github.com/you/memo-app.git
      8b41d07..c43e6a8  main -> main

7. up to date with 'origin/main' に戻り、ahead の行が消えました。手元の main と GitHub の写しが同じコミットにある、という意味です。

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

8. 送るものが無いときは Everything up-to-date と出て、何も変わりません。何度打っても害はありません。

   $ git push
   Everything up-to-date

9. もう1行書き足して、コミットします。

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

10. また手元の main だけが1つ先に進みました。

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

11. -q（quiet＝静かに）を付けると、うまくいったときは何も表示しません。中でしていることは git push と同じで、2枚の札が一緒に進みました。Claude Code はこの形をよく打ちます。

    $ git push -q

12. (HEAD -> main, origin/main, origin/HEAD) と同じ行に並びました。出力の無い push が届いたかどうかは、ここで確かめられます。

    $ git log --oneline -3
    492da8b (HEAD -> main, origin/main, origin/HEAD) バターを追加
    c43e6a8 パンを追加
    8b41d07 卵を追加

新しいブランチの push — 上流と push -u

1. main から作業用のブランチ memo を作って乗り換えます。この付箋は手元にしかなく、GitHub 側にはまだ memo がありません。

   $ git switch -c memo
   Switched to a new branch 'memo'

2. メモ用の新しいファイル notes.txt を作ります。

   $ echo "牛乳は低脂肪" > notes.txt

3. ステージに写します。

   $ git add notes.txt

4. 手元の memo が1つ進みました。このコミットは、まだ手元にしかありません。

   $ git commit -m "メモを追加"
   [memo ad1a0b0] メモを追加
    1 file changed, 1 insertion(+)
    create mode 100644 notes.txt

5. main の行には [origin/main] がありますが、memo の行には角かっこがありません。memo にはまだ 上流（push や pull の相手になる GitHub 側のブランチ）が決まっていない、という意味です。

   $ git branch -vv
     main e5c0a62 [origin/main] パンを追加
   * memo ad1a0b0 メモを追加

6. 上流が無いので、git push だけでは送り先が決まらず止まります。Git は git push --set-upstream origin memo を打てば送れる、と教えています。GitHub 側の図は何も変わっていません。

   $ git push
   fatal: The current branch memo has no upstream branch.
   To push the current branch and set the remote as upstream, use
   
       git push --set-upstream origin memo
   
   To have this happen automatically for branches without a tracking
   upstream, see 'push.autoSetupRemote' in 'git help config'.

7. -u は --set-upstream の短い書き方です。GitHub 側に memo ができ（* [new branch]）、手元に origin/memo の札が貼られ、branch 'memo' set up to track 'origin/memo'. で上流が決まりました。remote: で始まる行は GitHub からの返事で、プルリクエストを作る画面の URL です（2-4 で扱います）。

   $ git push -u origin memo
   remote: 
   remote: Create a pull request for 'memo' on GitHub by visiting:
   remote:      https://github.com/you/memo-app/pull/new/memo
   remote: 
   To https://github.com/you/memo-app.git
    * [new branch]      memo -> memo
   branch 'memo' set up to track 'origin/memo'.

8. memo の行に [origin/memo] が付きました。上流の設定は手元に残るので、-u は最初の1回だけで足ります。

   $ git branch -vv
     main e5c0a62 [origin/main] パンを追加
   * memo ad1a0b0 [origin/memo] メモを追加

9. notes.txt に1行書き足して、コミットします。

   $ echo "卵は10個入り" >> notes.txt

10. 手元の memo だけが1つ進みました。

    $ git commit -am "卵のメモを追加"
    [memo cd23d7e] 卵のメモを追加
     1 file changed, 1 insertion(+)

11. 上流があるので、ahead of 'origin/memo' by 1 commit と GitHub の写しとの差が出るようになりました。

    $ git status
    On branch memo
    Your branch is ahead of 'origin/memo' by 1 commit.
      (use "git push" to publish your local commits)
    
    nothing to commit, working tree clean

12. 今度は git push だけで送れます。ad1a0b0..cd23d7e memo -> memo で、GitHub 側の memo と手元の origin/memo が一緒に進みました。

    $ git push
    To https://github.com/you/memo-app.git
       ad1a0b0..cd23d7e  memo -> memo

先に push されていると拒否される

1. この Windows のノート PC では、手元の main も GitHub の main も「パンを追加」にあります。同じリポジトリを、もう1台の Mac でも使っているとします。

2. Mac で「バターを追加」をコミットして push しました。GitHub 側の main が1つ進みます。こちらのターミナルには何も出ません。

3. up to date with 'origin/main' と出ますが、比べている相手は手元にある GitHub の写しです。git status は GitHub に見に行かないので、Mac の push にはまだ気づいていません。

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

4. それを知らずに、こちらでも「ジャムを買う」を書き足してコミットします。

   $ echo "ジャムを買う" >> todo.txt

5. 手元の main が「パンを追加」から1つ進みました。GitHub 側の main も同じ「パンを追加」から別のコミットへ進んでいるので、歴史が2つに分かれています。

   $ git commit -am "ジャムを追加"
   [main bbe8599] ジャムを追加
    1 file changed, 1 insertion(+)

6. main -> main (fetch first) で拒否されました。GitHub 側に手元に無いコミットがあり、このまま main を進めると Mac の「バターを追加」が辿れなくなるからです。GitHub 側の図は何も変わっていません。

   $ 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.

7. 手元の履歴も何も変わっていません。「ジャムを追加」はそのまま残り、Mac の「バターを追加」はまだ手元に届いていないので出てきません。

   $ git log --oneline --all
   bbe8599 (HEAD -> main) ジャムを追加
   e5c0a62 (origin/main, origin/HEAD) パンを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

8. ahead of 'origin/main' by 1 commit のままです。拒否された push は、手元にも GitHub にも何も書き込みません。

   $ 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

9. 拒否は「先に GitHub の新しいコミットを取り込んでから送ってほしい」という合図です。取り込み方（git fetch と git pull）は、次の 2-3 で扱います。