git mergeの使い方を徹底解説！ブランチ統合の基本とコンフリクト回避のポイント

gitとGitHubとは？

アプリにコードをコントリビュート（寄稿）する際、通常はgitのフィーチャーブランチ上でコミットを行います。本ガイドでは、プロジェクトのコミットを最新状態に保ち、同期させる方法を解説します。あわせて、gitとGitHubの概要についても簡単に触れておきましょう。

gitは、コードに対するすべての変更履歴を記録するコマンドラインツールです。代表的なコマンドとして、変更をステージングする「git add」、変更を確定する「git commit」、変更を送信する「git push」があり、これらの一連の仕組みを「バージョン管理」と呼びます。

これらのコマンドでファイルへの変更を保存した後、「git push」コマンドを実行すると、GitHubなどのコードホスティングプラットフォームへファイルがアップロードされます。GitHubはファイルをリポジトリ単位で保管し、複数人でのコード共有を容易にします。

GitHubのようなコードホスティングプラットフォームの存在により、離れた場所にいるメンバー同士での共同開発が可能になりました。テクノロジー業界ではリモートワークへの移行が進んでおり、こうしたツールは今や不可欠なインフラといえます。

git mergeを使うべきタイミング

企業で他の開発者と協働している場合でも、趣味でオープンソースプロジェクトに貢献している場合でも、必ず「git merge」コマンドを使う場面が訪れます。ここで重要なのは、所属企業や参加するプロジェクトがコミットをどのようなルールで受け付けているのかを正確に把握しておくことです。作業を始める前に、チームメンバーやコミュニティに確認したり、コントリビューションガイドラインを読み込んだりしておきましょう。

一般的に、開発者はアプリの特定機能の実装を担当します。その際は、フィーチャーブランチ上でコードの変更をコミットしていくことになります。フィーチャーブランチとは、masterブランチから「分岐」させたブランチのことです。masterブランチには、本番環境にデプロイされる最終コードが置かれます。

開発段階ではフィーチャーブランチ上で作業することで、開発中に発生しうるバグからmasterブランチを守れます。フィーチャーブランチには、実装する機能にちなんだ名前を付けるのが慣例です。この時点で、あなたはmasterブランチから分岐したフィーチャーブランチ上で作業している状態になります。

次の図を見ると、ブランチの仕組みが視覚的によくわかります。

図には「topic」と「master」という2つのブランチが描かれています。topicブランチがフィーチャーブランチに相当します。A・B・Cは時系列に沿ったコミットを表し、Cがフィーチャーブランチ上の最新コミットです。一方、Gはmasterブランチ上の最新コミットです。

このような状況は、他のチームがコードレビューを通過した後にmasterブランチへコミットを行ったケースで発生します。リモートのmasterブランチの最新バージョンが、自分のマシン上のmasterブランチ（git pullで取得したもの）と異なるため、バージョンの不整合が生じます。このままマージすると、マージコンフリクト（競合）が発生する可能性があるのです。

git mergeの基本的な流れ

フィーチャーブランチ上で「git merge master」コマンドを実行すると、masterブランチの変更内容を自分のフィーチャーブランチに取り込めます。これにより手元のmasterブランチが最新化され、コードがレビューを通過した後は「git push origin master」で変更をmasterブランチへ反映できます。実際の作業は、おおむね次の流れで行います。

1. 「git checkout -b feature/機能名」でフィーチャーブランチを作成・切り替え
2. 機能を実装し、git add → git commit で変更を確定
3. 「git fetch origin」でリモートの最新情報を取得
4. 「git merge origin/master」でmasterの変更を取り込み、コンフリクトがあれば解消
5. 「git push origin feature/機能名」でリモートへプッシュし、プルリクエストを作成

繰り返しになりますが、masterブランチへのプッシュは、プロジェクトのコントリビューションガイドラインをすべて満たした場合に限定してください。未テストのコードによるバグや障害を防ぐため、masterブランチへ直接プッシュしないのがベストプラクティスです。

まとめ

gitコマンドを自在に使いこなせることは、あらゆる開発者にとって必須のスキルです。各コマンドを「いつ」「どのように」使うべきかを理解していれば、常に最新のコードを保持でき、他のブランチとのマージトラブルを未然に防げます。

企業のコードベースやオープンソースプロジェクトへの貢献という文脈でgitを使う場合は、必ずそのプロジェクトのガイドラインに従いましょう。プロジェクトごとにコードレビューの方法は異なるため、特に「git merge master」を使用する際には、ガイドラインの遵守が何よりも重要です。