HOWTO · Git

Git でブランチを作成して使用する方法

このチュートリアルでは、Git ブランチを紹介します。Git ブランチがプロジェクトの整理にどのように役立つかを見ていきます。

このページの内容

現在のコミットからブランチを作成するには、git branch feature/login を実行します。これによりブランチは作成されますが、現在のブランチに留まります。1つのステップでブランチを作成して切り替えるには、git checkout -b feature/login を使用します。Git のブランチはコミットへの軽量なポインタであるため、別の開始点を指定しない限り、どちらのコマンドも新しいブランチを現在のブランチのコミットから開始します。

git branch でブランチを作成して確認する

ローカルブランチを一覧表示するには、引数なしで git branch を実行します。Git は、現在チェックアウトされているブランチの前にアスタリスクを付けます。次の例では、一時リポジトリを作成し、コミットを1つ追加し、トピックブランチを作成して、ローカルブランチを一覧表示します。アスタリスクは、現在チェックアウトされているブランチを示します。シェルは終了時に一時リポジトリを削除します。

set -eu
tmp="$(mktemp -d)"
trap 'rm -rf "$tmp"' EXIT
git -C "$tmp" init -q -b main
git -C "$tmp" config user.name Example
git -C "$tmp" config user.email example@example.com
printf 'starter\n' > "$tmp/README.md"
git -C "$tmp" add README.md
git -C "$tmp" commit -qm "Add starter file"
git -C "$tmp" branch feature/login
git -C "$tmp" branch
  feature/login
* main

切り替えずにブランチを作成するには、git branch feature/login を実行します。現在のブランチの名前を変更するには git branch -m new-name を使用し、別のローカルブランチの名前を変更するには git branch -m old-name new-name を使用します。-m オプションはブランチの名前を変更します。ブランチを場所間で移動するものではありません。

マージ済みのローカルブランチについては、git branch -d feature/login は Git にその削除を求め、Git が未マージと見なす場合は拒否します。コミットが他の場所でマージされていない可能性がある場合でもローカルブランチの参照を削除する意図がある場合にのみ、git branch -D feature/login を使用してください。この方法でブランチを削除しても、別の参照を通じて到達可能なコミットは消去されませんが、そのブランチからのみ到達可能なコミットは、最終的に Git のクリーンアップによって削除される場合があります。

これらのコマンドはローカルブランチに影響します。origin という名前のリモートからブランチを削除するには、git push origin --delete feature/login を実行します。これではローカルブランチは削除されません。必要に応じて別途削除してください。

git checkout -b でブランチを作成して切り替える

既に存在するブランチに切り替えるには、git checkout existing-branch を使用します。現在のコミットに新しいブランチを作成してすぐに切り替えるには、git checkout -b feature/login を使用します。名前が既に存在する場合、Git はブランチを作成できないことを報告します。別の名前を選択するか、既存のブランチに切り替えてください。

安全に持ち越せる場合、コミットされていない編集は、ブランチを切り替えても作業ツリーに残ります。Git はそれらの編集をコミットしたり、新しいブランチだけに保存したりしません。それらはコミットされていないまま残り、切り替え先のブランチに現れることがあります。切り替えによって変更が上書きされる場合、Git は停止し、まず競合を解決するよう求めます。作業を別に保持する必要がある場合は、切り替える前に作業をコミットするか、git stash を使用してください。

切り替え後、git status を実行して現在のブランチを確認し、どのファイルが変更済みまたは未追跡のままかを確認します。たとえば、git checkout -b feature/login の後、git status は feature/login を示すはずです。互換性のある編集は、コミット、stash、または破棄するまで、作業ツリーの変更として引き続き表示されます。