git switchとcheckoutの違いと、ブランチの切り替え方
作業するブランチを切り替えるだけなら、git switch と git checkout のどちらを使っても結果は同じです。違いが出るのは、コミットを渡したとき、ブランチ名と同じ名前のファイルがあるとき、ブランチ名を打ち間違えたときです。git switch はブランチの切り替えしか受け付けないので、意図しない操作になりにくくなっています。新しいブランチを作って切り替える方法、直前のブランチに戻る方法、リモートにだけあるブランチを手元に持ってくる方法と合わせて、検証環境で git branch と git status を見ながら確かめました。
検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定しました。リモートは、同じ環境の中に作った空のリポジトリで代用しています。git switch は Git 2.23.0 で入ったコマンドで、それより古い Git にはありません。Windows・macOS、GitHub などのホスティングサービス上のリモートでは試していません。
git checkout の2つの役目が、switch と restore に分かれた
git checkout には、ブランチを切り替える役目と、ファイルを取り出して変更を捨てる役目の2つがあります。git checkout の公式リファレンスの冒頭にある一行の説明も「Switch branches or restore working tree files(ブランチの切り替え、または作業ツリーのファイルの復元)」です。Git 2.23.0 のリリースノートによると、この2つを分けるために git switch と git restore が加わりました。

ファイルを戻す側の git restore は、別の記事「git restoreで、消したファイルや変更を元に戻す方法」で扱っているので、ここではブランチを切り替える側を見ていきます。以下の例は、main と sale の2つのブランチがあるリポジトリで試しました。
$ git log --oneline --all
3d1f420 送料を400円に変更
ae84adb 最初のコミット
既にあるブランチに切り替える
git branch の一覧で、* が付いているのが今いるブランチです。git switch にブランチ名を渡すと、* の位置が sale に移りました。
$ git branch
* main
sale
$ git switch sale
Switched to branch 'sale'
$ git branch
main
* sale
$ git status
On branch sale
nothing to commit, working tree clean
git checkout にブランチ名を渡しても、同じように切り替わります。表示される文言も同じでした。
$ git checkout main
Switched to branch 'main'
$ git branch
* main
sale
直前のブランチに戻る
ブランチ名の代わりに - を渡すと、直前にいたブランチに戻ります。git switch の公式リファレンスでは、- は @{-1}(1つ前に切り替えたブランチ)と同じ意味で、2つのブランチを行き来するときや、間違えた切り替えを取り消すときに使うと説明されています。git checkout - でも同じように戻りました。
$ git switch -
Switched to branch 'sale'
$ git checkout -
Switched to branch 'main'
$ git branch --show-current
main
新しいブランチを作って、そのまま切り替える
git switch では -c、git checkout では -b を付けます。どちらも、今いるコミットから新しいブランチを作って切り替えます。
$ git switch -c campaign
Switched to a new branch 'campaign'
$ git branch
* campaign
main
sale
$ git switch main
Switched to branch 'main'
$ git checkout -b coupon
Switched to a new branch 'coupon'
$ git branch
campaign
* coupon
main
sale
既にある名前を渡すと、どちらもエラーになりました。
$ git switch -c campaign
fatal: a branch named 'campaign' already exists
$ git checkout -b campaign
fatal: a branch named 'campaign' already exists
ブランチ名を打ち間違えたとき
ここから、2つのコマンドの違いが出てきます。存在しないブランチ名(campaign のつもりで campain)を渡すと、エラーの文言が変わりました。
$ git switch campain
fatal: invalid reference: campain
$ git checkout campain
error: pathspec 'campain' did not match any file(s) known to git
git switch はブランチが見つからないと伝えています。一方 git checkout は、campain を「ファイル名」として探し、見つからなかったと伝えています。git checkout の公式リファレンスの書式の欄には、git checkout にファイル名(pathspec)を渡す使い方も並んでいます。
ブランチ名と同じ名前のファイルがあるとき
ファイル名として扱うこの動きは、ブランチ名とファイル名が同じときに問題になります。price.txt という名前のブランチを作り、ファイル price.txt を書き換えた状態で、変更を捨てるつもりで git checkout price.txt を実行しました。
$ git branch price.txt
$ echo "送料: 0円" > price.txt && git status --short
M price.txt
$ git checkout price.txt
Switched to branch 'price.txt'
M price.txt
$ git branch --show-current; git status --short
price.txt
M price.txt
変更は捨てられず、ブランチ price.txt に切り替わりました。git checkout の公式リファレンスの「ARGUMENT DISAMBIGUATION」の項には、渡したものがブランチ名にもファイル名にも当てはまるときは、ブランチの切り替えとして扱うと書かれています。ファイルとして扱わせたいときは、ファイル名の前に -- を付けます。
$ git switch main
Switched to branch 'main'
M price.txt
$ git checkout -- price.txt
$ git branch --show-current; git status --short; cat price.txt
main
送料: 400円
git switch の公式リファレンスの書式の欄には、ファイル名を渡す使い方がありません。打ち間違えたときの例でも、git switch はファイルを探さずに、ブランチが見つからないというエラーで止まりました。
コミットを指定して、昔の状態を見る
ブランチではなくコミットを渡したときも、動きが違います。git switch は、ブランチを渡すよう求めるエラーで止まりました。
$ git switch HEAD~1
fatal: a branch is expected, got commit 'HEAD~1'
hint: If you want to detach HEAD at the commit, try again with the --detach option.
git checkout はそのまま、どのブランチにもいない状態(detached HEAD)に切り替わります。
$ git checkout HEAD~1
Note: switching to 'HEAD~1'.
You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by switching back to a branch.
If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -c with the switch command. Example:
git switch -c <new-branch-name>
Or undo this operation with:
git switch -
Turn off this advice by setting config variable advice.detachedHead to false
HEAD is now at ae84adb 最初のコミット
$ git status | head -1
HEAD detached at ae84adb
表示された案内によると、この状態で作ったコミットは、ブランチに戻れば、どのブランチにも影響を与えずに捨てられます。残したいときは git switch -c <新しいブランチ名> でブランチを作れます。元に戻るときは git switch - です。
git switch で同じ状態にするには、--detach を付けます。detached HEAD にすることを、オプションで明示して切り替える形です。どのブランチにもいないので、git branch --show-current は何も表示しません。
$ git switch -
Previous HEAD position was ae84adb 最初のコミット
Switched to branch 'main'
$ git switch --detach HEAD~1
HEAD is now at ae84adb 最初のコミット
$ git branch --show-current; git status | head -1
HEAD detached at ae84adb
$ git switch main
Previous HEAD position was ae84adb 最初のコミット
Switched to branch 'main'
コミットしていない変更があるとき
今のブランチと切り替え先のブランチで内容が違うファイルを書き換えている場合は、どちらのコマンドも切り替えを止めます。ここでは、sale ブランチで送料を300円にしたコミットを作ってから、main で price.txt を書き換えました。git switch のエラーにも「checkout」と出ます。
$ echo "送料: 0円" > price.txt && git status --short
M price.txt
$ git switch sale
error: Your local changes to the following files would be overwritten by checkout:
price.txt
Please commit your changes or stash them before you switch branches.
Aborting
$ git checkout sale
error: Your local changes to the following files would be overwritten by checkout:
price.txt
Please commit your changes or stash them before you switch branches.
Aborting
一方、2つのブランチで内容が同じファイル(ここでは README.md)の変更なら、変更を持ったまま切り替わりました。切り替えたときに出る、M で始まる README.md の行は、変更が残っていることを示しています。
$ echo "メモ" >> README.md && git restore price.txt && git status --short
M README.md
$ git switch sale
Switched to branch 'sale'
M README.md
$ git status --short; cat README.md
M README.md
# 猫の手ストア
メモ
手元の変更を捨ててでも切り替えたいときは、--discard-changes(または -f)を付けます。git switch の公式リファレンスによると、ステージと作業ツリーを切り替え先の内容に合わせます。main に戻って price.txt も書き換え、2つのファイルに変更がある状態で試しました。
$ git switch main
Switched to branch 'main'
M README.md
$ echo "送料: 0円" > price.txt && git status --short
M README.md
M price.txt
$ git switch --discard-changes sale
Switched to branch 'sale'
$ git status --short; cat price.txt; cat README.md
送料: 300円
# 猫の手ストア
--discard-changes は、price.txt だけでなく、そのままでも持ち越せた README.md の変更まで捨てました。残したい変更は、先にコミットするか、git stash で退避してから使ってください。
リモートにだけあるブランチに切り替える
ほかの人がリモートに作ったブランチを手元で使う場面です。git fetch のあとの git branch -a には、リモートのブランチ remotes/origin/review が見えますが、手元に review ブランチはありません。
$ git fetch -q origin
$ git branch -a
campaign
coupon
* main
sale
remotes/origin/main
remotes/origin/review
origin/review をそのまま渡すと、git switch はブランチを渡すよう求めるエラーで止まります。origin/ を付けずに review と渡すと、手元に review ブランチが作られ、origin/review を追跡する設定まで済みました。
$ git switch origin/review
fatal: a branch is expected, got remote branch 'origin/review'
hint: If you want to detach HEAD at the commit, try again with the --detach option.
$ git switch review
Switched to a new branch 'review'
branch 'review' set up to track 'origin/review'.
$ git branch -vv
campaign 3d1f420 送料を400円に変更
coupon 3d1f420 送料を400円に変更
main 3d1f420 送料を400円に変更
* review 35047d9 [origin/review] お知らせを追加
sale 0c615e9 セールで送料を300円に
git switch の公式リファレンスの --guess の項によると、渡した名前のブランチが手元になく、同じ名前のブランチが1つのリモートにだけあるときは、git switch -c review --track origin/review と同じ動きになります。この動きは既定で有効です。手元の review を消してから git checkout review でも試すと、同じ結果になりました。
$ git checkout review
Switched to a new branch 'review'
branch 'review' set up to track 'origin/review'.
$ git branch -vv
campaign 3d1f420 送料を400円に変更
coupon 3d1f420 送料を400円に変更
main 3d1f420 送料を400円に変更
* review 35047d9 [origin/review] お知らせを追加
sale 0c615e9 セールで送料を300円に
書き換えるときの対応表
ブランチの切り替えに使う git checkout は、次のように git switch に置き換えられます。検証環境では、左右どちらでも、切り替わった先の状態は同じになりました。コミットを渡す行だけは、git switch では --detach が必要で、git checkout だけが detached HEAD の長い案内を出します。
| やりたいこと | git checkout | git switch |
|---|---|---|
| ブランチを切り替える | git checkout sale |
git switch sale |
| 直前のブランチに戻る | git checkout - |
git switch - |
| 作って切り替える | git checkout -b campaign |
git switch -c campaign |
| コミットを見る | git checkout HEAD~1 |
git switch --detach HEAD~1 |
| リモートのブランチを使う | git checkout review |
git switch review |
ファイルの変更を捨てる git checkout -- ファイル名 は、git switch ではなく git restore ファイル名 に置き換えます。





