ブランチを新規作成、削除、一覧するためのコマンドです。ブランチの名前の変更を行うこともできます。
git branch の概要
ブランチを新規作成、削除、一覧するためのコマンドです。
主に-d オプションによるブランチの削除や、ブランチ状態を確認するために使うことが多く、レポジトリの管理の目的で使うことが多いでしょう。
使用例
ブランチの新規作成
実際の作業では、このコマンドを使わずに「git checkout -b <branch name> [<start point>]」を使って、ブランチの新規作成とチェックアウトを同時に行う事が多くなるでしょう。
// 現在のブランチから、fix/typoブランチを派生する git branch fix/typo // masterブランチから、feature/add-formブランチを派生する git branch feature/add-form master
もしリモートレポジトリに新しいブランチが存在し、それがまだローカルにない場合、同じブランチ名を指定することで、自動的に、リモートブランチを上流ブランチとするローカルブランチを生成されます。
ブランチの一覧
ブランチを閲覧します。-vvとvを二度重ねることで、上流ブランチを合わせて表示します。下記の例を使えば、網羅的なブランチ情報が一覧できるはずです。
// すべてのブランチと、ブランチヘッドのSHA-1、コミットメッセージを一覧。 git branch -vva
参考
ブランチの削除
不要なローカルブランチを削除できます。
// tmp/debug-formブランチを削除する git branch -d tmp/debug-form
-d オプションでは、マージされていないブランチを削除することができません。マージされていないブランチは、この操作によりそのブランチの変更内容が失われてしまうため誤操作によるリスクを防止するためです。そのような場合、警告がでて中断されますので、代わりに -D オプションを付けて実行すればブランチの削除を強制できます。
ブランチ名の変更
名前の衝突やその調整のため、ブランチ名を変更することも実際の開発では少なくないと思います。
// ブランチ名を変更する git branch -m my-branch our-branch
主要なオプション
-u <upstream>, --set-upstream-to=<upstream>
指定されたリモートブランチを上流ブランチとして設定します。もし引数でローカルブランチ名が指定されなければ、現在のブランチを対象にします。
その他のオプション
git branchで利用可能な主なオプション
| オプション | 詳細 |
| -d --delete |
ブランチを削除します。 |
| -D | -df, --delete --force のショートカットです。 |
| -m --move |
ブランチ名を変更します。 |
| -M | -mf --move --fouce のショートカットです。 |
| -r --remotes |
リモートブランチを一覧します。 |
| -a --all |
すべてのブランチを一覧します。 |
| -v --verbose |
ブランチを一覧する際に、SHA-1とコミットメッセージを表示します。 |
| -vv | -v に、上流ブランチの情報を追加します。 |
Git公式ドキュメント
Git公式ドキュメント「git branch」へのリンクです。