社内でgit checkout でブランチを切り替えたり、変更を破棄したりしている方がいたので、git checkoutを使用している方に向けて「checkoutは使わんで！」という内容を書きます。

`git checkout`は多機能で怖いから `switch`, `restore`使え！

突然ですが、ブランチの切り替えやちょっとした修正の取り消しに、git checkout コマンドを使っていませんか？手に馴染んだコマンドで、つい指が動いてしまう方も多いかと思います。自分ちょうど一年前まではcheckout使ってました。

ですが、その便利なはずの git checkout には、 意図しない事故を引き起こしかねない「怖さ」 が潜んでいるんです。

`checkout` の何がそんなに「怖い」のか？

結論から言うと、checkout は役割が多すぎるのが問題です。
このコマンドは、大きく分けて以下の2つの全く異なる操作を実行します。

「ブランチ操作」と「ファイル操作」という、コンテキストが全く違う作業を同じコマンドが担当しているため、こんな悲劇が起こり得ます。

あなたが feature/AB-123 というブランチに切り替えようとして、うっかりこう入力したとします。

# ブランチ名をタイポした
$ git checkout feature/AB-12

もし feature/AB-12 という名前のファイルやディレクトリが過去のコミットに存在した場合、Gitは「お、このファイルの状態に戻したいんだな」と解釈して、あなたの作業ツリーにある同名のファイルを警告なしに上書きしてしまう可能性があります。

このような事故を防ぐため、Git 2.23から checkout の機能は2つの専門家コマンドに分割されました。

ブランチを「切り替える(switch)」ことだけに責任を持ちます。ファイル操作は一切行いません。

ファイルの変更を「元に戻す(restore)」ことだけに責任を持ちます。ブランチ操作は一切行いません。
役割が完全に分かれているため、もう間違うことはありません。

もちろん、git checkout がすぐに使えなくなるわけではありませんが、コードを守るために、より安全で明確な方法があるなら、それを使わない手はありません。

今日からブランチを移動するときは git switch を、**ファイルの変更を取り消すときは git restore ** を意識して使ってみてください。

皆さんの日々の開発が、少しでも安全で快適になりますように。