リモートブランチにチェックアウト

よく忘れるのでメモ。

やりたいこと

• ローカルでmaster以外のリモートブランチにチェックアウトする

ローカルのブランチ一覧

$ git branch
* master

リモートのブランチ一覧

$ git branch -r
origin/HEAD -> origin/master
origin/add-whitespace-mode
origin/master

このように、リモートブランチはローカルだと

$ リポジトリURL(origin)/ブランチ名

という名前で表される。一方、git pullは

$ git pull origin master

のように、第一引数にorigin (リポジトリURL)を取るので第二引数にorigin/と書かなくてもリモートブランチを表す。ここが紛らわしい。

ちなみに、origin/HEAD -> origin/masterはリモートリポジトリのデフォルト(origin/HEAD)がorigin/masterであることを表している。これが設定されていると、リモートリポジトリのレポジトリ名だけ指定したときに、そのデフォルトブランチが指定されたものとして振る舞う（後述）。リモートレポジトリのHEADは、

$ git remote set-head origin master(HEADブランチ)

で指定できる。

ローカルのリモートブランチの情報を最新化

$ git fetch

ローカルでリモートブランチにチェックアウト

$ git checkout -b NEW-BRANCH-NAME origin/REMOTE-BRANCH-NAME

第一引数が新しくローカルに作るブランチの名前で、第二引数はリモートブランチ名。問題なければNEW-BRANCH-NAMEはREMOTE-BRANCH-NAMEとあわせたほうが良さそう。 例えば、

$ git checkout -b add-whitespace-mode origin/add-whitespace-mode

のように。-bは作ったブランチに移動するためのオプション。

また、origin/HEADがorigin/masterを指しているとき、

$ git checkout -b NEW-BRANCH-NAME origin

は、

$ git checkout -b NEW-BRANCH-NAME origin/master

と同じ意味になる。