git push と git push -uの違い

Question

git push origin master と git push -u origin master
の違いについて、何かわかりやすい例などを挙げて、教えていただきたいです。

よろしくお願い致します。

Answer 1

こんにちは、shota_catさん

実際の挙動としては、

git push origin master ... (1)
git push -u origin master ... (2)

ともに、リモートのoriginリポジトリにmasterブランチをpushする動作を示しています。

ただ、(2)のコマンドを実行する前に、以下のgit pushのみのコマンドを実行すると、以下のようなエラーになります。

$ git push
fatal: The current branch master has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin master

git push -u origin master と
git push --set-upstream origin master は同義です。

エラーの通り「masterブランチにupstreamブランチがない。」となっています。
逆にいうと、upstreamブランチが設定されていれば、リモートブランチもローカルブランチも指定せずにpushすることができます。

そのため、一度
git push -u origin master でpushとともにupstreamを設定しておけば、
次回からは、コミット後、
git push
で、pushすることができるようになります。

またupstreamの紐付けについては、

.git/config/ に

[branch "master"]
  remote = origin
  merge = refs/heads/master

のように記載されています。

以上、参考になれば幸いです。