Git Ready
ブランチを切り替える(旧式) - git checkout の使い方・オプション・サンプル

ブランチを切り替える(旧式)- git checkout

ブランチの切替やファイルの復元を行います。

概念図

git checkout diagram

構文

bash
git checkout <branch>

使用例

mainブランチに切り替え

bash
git checkout main

新しいブランチを作成して切り替え

bash
git checkout -b feature/new

概要:2つの役割を持つ多機能コマンド

このコマンドは「ブランチの切り替え」と「ファイルの復元」という2つの異なる役割を持っています。

Git 2.23 以降では、この2つの役割を明確に分離するために git switch(ブランチ切り替え)と git restore(ファイル復元)が導入されました。

現在でも git checkout は広く使われていますが、新しいプロジェクトでは用途に応じて git switchgit restore の使用が推奨されています。

既存のスクリプトやドキュメントでは checkout が頻出するため、どちらの使い方も理解しておくことが大切です。

注意点

  • git checkout -- <file> は取り消せない

    ファイルを元に戻す操作は取り消しができません。ワーキングツリーの変更が完全に失われるため、実行前に本当に必要か確認してください。

  • コミットハッシュ指定で detached HEAD になる

    git checkout <commit-hash> で特定のコミットに移動すると「detached HEAD」状態になります。状態の意味・抜け出し方・作業を失わないためのリカバリ手順は、ガイド detached HEAD から安全に戻る方法 を参照してください。

  • 多機能ゆえの誤操作リスク

    git checkout は多機能ゆえに、意図しない動作を引き起こすことがあります。ブランチ切り替えには git switch、ファイル復元には git restore を使うことで、より安全に操作できます。

関連コマンド