初めに

Gitをチーム開発で1年ほど使用
コマンド操作には慣れてきたが、git checkout 時に origin を書く必要がある場合とそうでない場合があり、動作の違いを明確に理解できていなかったため調査しました。

概要

Gitではリモートブランチを操作する際に、

git checkout origin/hotfix/feature-x

と書く場合と、

git checkout hotfix/feature-x

とする場合があり、後者だけ成功することがあります。

この違いがなぜ生まれるのか、Gitの内部動作を踏まえて整理しました。

ローカルにそのブランチが存在しないとき、Gitは以下のように動作します。

リモート追跡ブランチ origin/hotfix/feature-x が存在する場合、Gitは自動的にローカルブランチを作成し、追跡ブランチとして設定してくれます。

git fetch origin
git checkout hotfix/feature-x

これは裏で以下のような動作をしてくれているのと同じになります。

git checkout -b hotfix/feature-x origin/hotfix/feature-x

出力例：

branch 'hotfix/feature-x' set up to track 'origin/hotfix/feature-x'.
Switched to a new branch 'hotfix/feature-x'

一方、こちらの書き方は別の意味になります。

git checkout origin/hotfix/feature-x

これはリモート追跡ブランチをそのままチェックアウトするという意味であり、編集・コミットができません。

いわば「読み取り専用モード」でのブランチ切り替えです。

また、以下のようなミスも発生しやすいです。

git checkout origin hotfix/feature-x
# ❌ エラー：Gitは "origin" というリモートと "hotfix/..." を同時に扱えない

git checkout -b hotfix/feature-x origin/hotfix/feature-x

git switch -c hotfix/feature-x --track origin/hotfix/feature-x

Gitではよく以下のようなPushコマンドを使います。

git push origin hotfix/feature-x

これは：

「このブランチを origin って名前のリモートリポジトリに送ってね！」という意味

一方、以下のような checkout の使い方をしようとすると混同しやすくなります。

git checkout origin/hotfix/feature-x

これは：

「originリモートにあるブランチを一時的に読み取り専用で見るね！」

git push origin ブランチ名
→ 「データ送るから受け取ってね、origin先生！」
git checkout origin/ブランチ名
→ 「origin先生のところにあるメモだけ見せて」
❌ git checkout origin ブランチ名
→ 「originって人とブランチ名って人を同時に呼び出す」謎コマンド

Git「えっ、何？どこ見ればいいの？わかんない…（爆死＼(^o^)／）」