HOWTO · Git

Git Merge Master と Git Merge Origin/Master の違い

git merge master コマンドと git merge origin/master コマンドを区別します。

このページの内容

git merge は、引数で指定したコミットを現在チェックアウトしているブランチに統合します。ブランチは切り替わりません。git merge master と git merge origin/master の違いは、マージ元のコミットです。一方はローカルブランチで指定され、もう一方はローカルのリモート追跡参照で指定されます。

git merge origin/master の仕組み

origin/master は、origin にある master というリモートブランチを最後に取得したときの状態を記録します。これはローカルに保存されるため、誰かが新しいコミットをプッシュしても自動では更新されません。そのリモートからリモート追跡参照を更新するには、git fetch origin を実行します。fetch はコミットをダウンロードして記録しますが、現在のブランチにマージしたり、ローカルの master ブランチを移動したりはしません。

取得したコミットを feature に取り込むには、変更を受け取るブランチに切り替え、fetch を実行してからマージします。

git switch feature
git fetch origin
git merge origin/master

これらのコマンドは未実行の例であり、結果はリポジトリの履歴によって異なります。マージ前に fetch を実行し、origin/master が取り込みたいリモートの状態を示すようにしてください。fetch しない場合、Git はローカルに記録されている古い値を使います。変更の取り込み先が不明な場合は、マージ前に git branch --show-current で現在のブランチを確認してください。

feature ブランチにマージ元のコミット以降のコミットがなければ、Git はブランチのポインターを早送りすることがあります。両方のブランチに新しいコミットがある場合は、マージコミットが作成されることがあります。編集箇所が重なると、競合の解決が必要になる場合もあります。早送りは起こり得る結果の一つであり、保証されるものではありません。

git merge master の仕組み

master は、リポジトリ内のローカルブランチを指します。まだプッシュしていないコミットが含まれている場合や、更新していないためリモートより遅れている場合があります。このローカルブランチを feature にマージするには、まず変更を受け取るブランチに切り替えます。

git switch feature
git merge master

この操作では origin から fetch せず、ローカルの master も更新されません。Git は、ローカルの master が現在指しているコミットを、チェックアウト中のブランチに統合します。コミットグラフとファイルの変更内容によって、結果は早送り、マージコミット、または競合のいずれかになります。このコマンド列は未実行の例であり、別のリポジトリで特定の出力が得られるとは限りません。

目的に合ったマージ元を選ぶ

取り込みたいコミットがすでにローカルの master ブランチにある場合は、git merge master を使います。ローカルの master がリモートと同じ状態かどうかにかかわらず、リモートの master ブランチを最後に fetch した状態を使いたい場合は、git fetch origin を実行してから git merge origin/master を実行します。どちらの場合も、マージ前に変更を受け取るブランチをチェックアウトしてください。

この二つの名前が異なるコミットを指すことがあります。ローカルの master に未プッシュの作業が含まれている一方で、origin/master には共同作業者から取得したコミットが含まれている場合があります。fetch が更新するのはリモート追跡参照であり、ローカルの master ではありません。これらの名前が示すコミット集合を比較するときは、Git がブランチ名だけでなくコミットの祖先関係を考慮することを覚えておいてください。次の簡単なモデルでは、各集合を参照から到達可能なコミットとして扱い、feature からまだ到達できない候補を列挙します。

代表的なコミット ID を使って、この簡単なモデルを実行します。

このセクションのコードと表示されるラベルや出力は英語のままです。

refs = {
    "master": {"base", "local-change"},
    "origin/master": {"base", "remote-change"},
}
feature = {"base", "feature-change"}

for ref, reachable in refs.items():
    candidates = sorted(reachable - feature)
    print(f"{ref}: {', '.join(candidates)}")
master: local-change
origin/master: remote-change

この集合モデルは、例に出てくる名前を簡潔に比較するためのものです。マージに必要なコミットは、Git が実際のコミットグラフを使って判断します。ローカルの master をリモートに追従させたい場合は、別途 master に切り替えて origin/master をマージします。これは feature にマージする場合とは、変更を受け取るブランチが異なります。

これらのマージコマンドに関するよくある質問

master と origin/master の両方をマージできますか? はい。それぞれがマージ元のコミットを指定し、Git は現在のブランチからまだ到達できないコミットを統合します。二つの参照が同じコミットを指していたり、一方がもう一方の履歴の大部分を含んでいたりする場合、二回目のマージで何も追加されないことがあります。異なるコミットが含まれている場合もあります。履歴を確認して慎重に選んでください。確認せずに両方をマージすると、意図していない変更が取り込まれることがあります。

git merge origin/master を実行すると、ローカルの master は更新されますか? いいえ。マージで更新されるのは現在チェックアウトしているブランチです。git fetch origin はリモート追跡参照を更新します。feature にいるときにその参照をマージすると、コミットは feature に統合されます。

最近のリモートコミットがマージに含まれなかったのはなぜですか? ローカルの origin/master が古い状態かもしれません。正しいリモートから fetch し、マージ前にマージ元の参照を確認してください。また、そのコミットが master というリモートブランチにあることも確認します。別のリモートやブランチにある場合は、異なる参照を指定する必要があります。