ブランチ

Git のブランチという概念と、ブランチを使った開発の進め方を整理します。

1. ブランチとは

ブランチは、開発の流れを分岐させる仕組みです。メインの開発ライン(mainブランチ)に影響を与えずに、新機能の開発やバグ修正を行えます。

たとえば、検索機能を追加したい場合、mainブランチからfeature/add-searchという新しいブランチを作成します。このブランチ上で検索機能の実装を進めている間も、mainブランチはそのままの状態を保っています。検索機能の実装が完了したら、feature/add-searchブランチの変更をmainブランチにマージ(統合)することで、mainブランチに検索機能が反映されます。このように、ブランチを使うことで本番のコードに影響を与えることなく安全に開発を進められます。

2. ブランチの基本操作

現在のリポジトリに存在するブランチの一覧を表示します。

git branch

現在チェックアウトしている(作業中の)ブランチには*マークが付いて表示されます。

* main
  feature/add-search
  fix/login-bug

新しいブランチを作成するには、git branchの後にブランチ名を指定します。ただし、このコマンドはブランチを作成するだけで、作業ブランチの切り替えは行いません。

git branch ブランチ名

作業するブランチを切り替えるには、git switchを使用します。切り替えると、ワーキングディレクトリのファイルが指定したブランチの状態に更新されます。

git switch ブランチ名

実際の開発では、新しいブランチを作成してすぐにそのブランチで作業を始めることがほとんどです。-cオプションを付けると、ブランチの作成と切り替えを1つのコマンドで同時に行えます。

git switch -c ブランチ名
💡 ポイント
以前はブランチの切り替えにgit checkoutが使われていましたが、Git 2.23以降ではgit switchが推奨されています。checkoutはブランチ切り替え以外にも多くの用途があり紛らわしいため、ブランチ操作にはswitchを使うのが現在のベストプラクティスです。

3. マージ

あるブランチの変更を別のブランチに取り込む操作です。まず取り込み先のブランチに切り替えてから、マージを実行します。

git switch main
git merge feature/add-search

マージが完了したら、不要になったブランチを削除できます。

git branch -d feature/add-search

3.1 マージコンフリクト

マージを実行した際、同じファイルの同じ箇所を複数のブランチで異なる内容に編集していた場合、Gitはどちらの変更を採用すべきか判断できず、コンフリクト(競合)が発生します。

たとえば、mainブランチでgreeting.pyの挨拶メッセージを"Hello, Team!"に変更し、同時にfeature/add-searchブランチでも同じ箇所を"Hello, World!"に変更していた場合、マージを実行するとコンフリクトが発生します。コンフリクトが発生したファイルを開くと、以下のようなマーカーが挿入されています。

<<<<<<< HEAD
    print("Hello, Team!")
=======
    print("Hello, World!")
>>>>>>> feature/add-search

<<<<<<< HEADから=======までが現在のブランチ(main)の内容、=======から>>>>>>> feature/add-searchまでがマージしようとしているブランチの内容です。

コンフリクトを解決するには、マーカーを削除し、最終的に残したい内容にファイルを修正します。たとえば、以下のようにどちらかを選択するか、両方を組み合わせた内容に書き換えます。

    print("Hello, World!")

修正が完了したら、git addでステージングし、git commitを実行してマージを完了させます。

git add greeting.py
git commit -m "fix: マージコンフリクトを解決"
💡 ポイント
コンフリクトは、チーム開発では避けて通れないものです。こまめにブランチの変更を取り込む(mainブランチの最新を自分のブランチにマージする)習慣をつけることで、コンフリクトの発生頻度や規模を最小限に抑えることができます。また、Visual Studio Codeにはコンフリクト解決を支援する機能が搭載されており、「Accept Current Change」「Accept Incoming Change」「Accept Both Changes」といった選択肢をクリックするだけで簡単にコンフリクトを解決できます。