Git ブランチが main ブランチに完全にマージされているかどうかを確認する方法

はじめに

この実験では、Git のブランチが別のブランチ、特に main ブランチに完全にマージされているかどうかを効果的に確認する方法を学びます。これは、Git リポジトリをきれいに整理して維持するために重要なスキルです。

まず、git branch --merged main コマンドを使用して、main ブランチに完全に統合されたブランチを特定します。その後、git log main ^branch コマンドを使用して結果を検証し、ターゲットブランチのすべてのコミットが main ブランチに含まれていることを確認します。最後に、部分的にマージされたブランチでこれらの方法をテストし、異なる結果を理解します。

Skills Graph

git branch --merged main を使用する

このステップでは、git branch --merged コマンドを使って、どのブランチが別のブランチに完全に統合されているかを確認する方法を学びます。このコマンドは、リポジトリをきれいに整理して維持するのに非常に役立ちます。

まず、プロジェクトディレクトリにいることを確認しましょう。ターミナルを開き、my-time-machine ディレクトリに移動します。

cd ~/project/my-time-machine

次に、feature-branch という名前の新しいブランチを作成し、そのブランチに切り替えます。このブランチでいくつかの変更を加えるシミュレーションを行います。

git branch feature-branch
git checkout feature-branch
echo "Adding a new feature" >> feature.txt
git add feature.txt
git commit -m "Add new feature"

コミット後、以下のような出力が表示されるはずです。

[feature-branch a1b2c3d] Add new feature
 1 file changed, 1 insertion(+)
 create mode 100644 feature.txt

次に、master ブランチに戻り、feature-branch を master ブランチにマージします。

git checkout master
git merge feature-branch

マージが成功したことを示す出力が表示されるはずです。

Updating e1f2g3h..a1b2c3d
Fast-forward
 feature.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 feature.txt

feature-branch を master ブランチにマージしたので、git branch --merged を使って、master ブランチに完全にマージされたブランチを確認しましょう。

git branch --merged master

このコマンドは、すべてのコミットが master ブランチに取り込まれたブランチをすべてリスト表示します。master と feature-branch がリストに表示され、feature-branch が master ブランチに完全にマージされたことがわかります。

どのブランチがマージされているかを理解することは、安全に削除できるブランチを特定し、リポジトリを整然と保つのに重要です。これは、ゲームで完了したサイドクエストを把握し、これから無視できるようにするのと似ています。

git log main ^branch で検証する

前のステップでは、git branch --merged を使って、master ブランチにマージされたブランチを確認しました。今度は、別のコマンド git log を使って、別の視点からこれを検証しましょう。main ^branch 構文を使った git log コマンドは、main ブランチに含まれているが branch ブランチには含まれていないコミットを確認する強力な方法です。

まず、my-time-machine ディレクトリにいることを確認しましょう。

cd ~/project/my-time-machine

次に、git log を使って、master ブランチに含まれているが feature-branch ブランチには含まれていないコミットを確認しましょう。

git log master ^feature-branch

前のステップで feature-branch を master ブランチに完全にマージしたので、feature-branch のすべてのコミットが master ブランチにも含まれるようになりました。したがって、このコマンドは、マージ前に元々 master ブランチにのみ存在していたコミットを表示するはずです。feature-branch で行った「Add new feature」というコミットは表示されないはずです。

以下のような出力が表示され、master ブランチの最初のコミットのみが表示されるはずです。

commit e1f2g3h4i5j6k7l8m9n0o1p2q3r4s5t6u7v8w9x (HEAD -> master)
Author: Jane Doe <[email protected]>
Date:   Mon Aug 7 10:00:00 2023 +0000

    Send a message to the future

もし feature-branch が完全にマージされていなかった場合、このコマンドは master ブランチにあるが feature-branch ブランチにないコミット、および feature-branch ブランチにあるが master ブランチにないコミットを表示します。ここで「Add new feature」コミットが表示されないことは、このコミットが現在 master ブランチに含まれていることを確認するものです。

この git log main ^branch 構文は、あるブランチのすべてのコミットが別のブランチに含まれているかどうかを視覚的に確認する素晴らしい方法です。これにより、リポジトリ内の異なるブランチ間の関係を理解するのに役立ちます。

部分的にマージされたブランチでテストする

前のステップでは、git branch --merged と git log main ^branch が完全にマージされたブランチでどのように動作するかを見ました。今度は、部分的にマージされたブランチ、つまり一部のコミットのみが別のブランチに統合されたブランチで何が起こるかを見てみましょう。

まず、my-time-machine ディレクトリにいることを確認しましょう。

cd ~/project/my-time-machine

partial-feature という名前の新しいブランチを作成し、そのブランチに切り替えましょう。

git branch partial-feature
git checkout partial-feature

この新しいブランチで 2 つのコミットを行いましょう。

echo "Adding part 1 of the feature" >> partial.txt
git add partial.txt
git commit -m "Add part 1"
echo "Adding part 2 of the feature" >> partial.txt
git add partial.txt
git commit -m "Add part 2"

コミット後、以下のような出力が表示されるはずです。

[partial-feature a1b2c3d] Add part 1
 1 file changed, 1 insertion(+)
 create mode 100644 partial.txt
[partial-feature e1f2g3h] Add part 2
 1 file changed, 1 insertion(+)

次に、master ブランチに戻り、partial-feature の最初のコミットのみをマージしましょう。これは git cherry-pick を使って行うことができます。まず、「Add part 1」コミットのコミットハッシュが必要です。git log partial-feature を実行し、最初のコミットのハッシュをコピーすることで見つけることができます。

git checkout master
## <commit_hash> を「Add part 1」コミットの実際のハッシュに置き換える
git cherry-pick <commit_hash>

チェリーピックが成功したことを示す出力が表示されるはずです。

[master i1j2k3l] Add part 1
 Date: Mon Aug 7 10:05:00 2023 +0000
 1 file changed, 1 insertion(+)
 create mode 100644 partial.txt

次に、再度 git branch --merged master を使用しましょう。

git branch --merged master

master と feature-branch がリストに表示されるはずですが、partial-feature は表示されません。これは、partial-feature にはまだ「Add part 2」コミットがあり、これが master ブランチにマージされていないためです。git branch --merged は、すべてのコミットがターゲットブランチに存在するブランチのみをリスト表示します。

最後に、git log master ^partial-feature を使用しましょう。

git log master ^partial-feature

このコマンドは、master ブランチに含まれているが partial-feature ブランチには含まれていないコミットを表示します。master ブランチの最初のコミット、「Add new feature」コミット（現在は master ブランチにあります）、および「Add part 1」コミット（チェリーピックしたもの）が表示されるはずです。「Add part 2」コミットは表示されません。このコミットは partial-feature ブランチにのみ存在するからです。

これは、git branch --merged と git log main ^branch が、一部のコミットのみが統合されている場合でも、ブランチのマージ状況を理解するのにどのように役立つかを示しています。

まとめ

この実験では、Git のブランチが別のブランチ、具体的には main（または master）ブランチに完全にマージされているかどうかを確認する方法を学びました。まず、git branch --merged main コマンドを使用しました。このコマンドは、すべてのコミットが main ブランチに完全に組み込まれているブランチをすべてリスト表示します。これは、クリーンアップが可能なブランチを迅速に特定する方法です。

次に、git log main ^branch を使用した、より細かい検証方法を調べました。このコマンドは、main ブランチに含まれているが指定したブランチには含まれていないコミットを表示します。このコマンドが何も出力しない場合、そのブランチのすべてのコミットが main ブランチに存在することが確認され、完全なマージが検証されます。最後に、部分的にマージされたブランチでこれらの方法をテストし、出力の違いを理解し、ブランチのマージ状況を正確に判断する方法についての理解をさらに深めました。