Git で上流ブランチを設定する方法

新しいブランチをプッシュして上流に設定するには、`git push -u origin my-branch` を実行します。 ブランチがリモートにすでに存在する場合は、代わりに git branch -u origin/my-branch を実行します。その後、普通の git push と git pull はどこに行くべきかを知っています。 -u は --set-upstream の短縮形です。

Git の上流ブランチとは何ですか?

アップストリームはトラッキング ブランチとも呼ばれ、ローカル ブランチにリンクされたリモート ブランチです。 Git は、このリンクを 3 つの目的で使用します。それは、git pull と git push が引数なしで使用される場合、git status の前後のカウントが何と比較されるか、短縮形の @{u} が何を意味するかということです。

新しいブランチの上流を設定するにはどうすればよいですか?

git switch -c feature/search
git push -u origin feature/search

これにより、リモート上にブランチが作成され、2 つがリンクされます。最初のプッシュでは -u のみが必要です。 ブランチの作成と切り替えガイド では、この前のステップについて説明しています。

既存のブランチの上流を設定するにはどうすればよいですか?

リモート ブランチがすでに存在する場合は、プッシュせずにリンクします。

# the branch you are on
git branch -u origin/feature/search

# any other branch
git branch -u origin/main main

長い形式は git branch --set-upstream-to=origin/main です。 Git がリモート ブランチが存在しないと判断した場合は、最初に git fetch を実行します。

「現在のブランチには上流ブランチがありません」を修正するにはどうすればよいですか?

これまでプッシュされていないブランチで git push を実行すると、Git はこれを出力します。

fatal: The current branch feature/search has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin feature/search

提案されたコマンドを実行します。エラーの表示を停止するには、最初のプッシュごとに Git にこれを実行させます (Git 2.37 以降)。

git config --global push.autoSetupRemote true

関連メッセージ「現在のブランチの追跡情報がありません」は git pull から送信されています。修正内容は同じです: git branch -u origin/my-branch。

ブランチの軌跡を確認するにはどうすればよいですか?

# every branch, with its upstream and ahead/behind
git branch -vv

# only the current branch
git rev-parse --abbrev-ref @{u}

# commits you have not pushed
git log @{u}..

# commits you have not pulled
git log ..@{u}

アップストリームを変更または削除するにはどうすればよいですか?

# point the branch somewhere else
git branch -u origin/develop

# stop tracking anything
git branch --unset-upstream

どちらのコマンドでもコミットは変更されません。 .git/config のブランチの設定のみを編集します。

分岐の上流とは何を意味しますか?

この言葉には2番目の意味があります。フォークでは、upstream は慣例により リモート、つまりフォーク元の元のプロジェクトの名前ですが、origin は独自のコピーです。それが「git Remote add Upstream」の内容です。

git remote add upstream https://github.com/original/project.git
git fetch upstream
git switch main
git merge upstream/main
git push origin main

詳細については トラッキングの設定とブランチの公開 を参照し、練習するには リモートとアップストリームのレッスン を参照してください。