Git は、開発者が変更を追跡し、プロジェクトで共同作業を行い、コードベースの完全な履歴を維持することを可能にする強力なバージョン管理システムです。Git における不可欠なスキルの一つは、リモートブランチのコミット履歴を表示する方法を知ることです。これにより、プロジェクトがどのように進化してきたか、誰が特定の変更に貢献したかを理解することができます。
このラボでは、実際の GitHub リポジトリを使用して、リモート Git ブランチのコミット履歴を表示および解釈する方法を学びます。この知識は、プロジェクトの進化をより深く理解し、問題をデバッグし、チームとより効果的に共同作業するのに役立ちます。
リモートブランチのコミット履歴を探索する前に、Git リポジトリの基本的な構造と、ローカルでコミット履歴を表示する方法を理解しましょう。
この実験では、GitHub の git-playground リポジトリという実際の Git リポジトリを使用します。それに移動して探索してみましょう。
cd ~/project/git-playgroundGit リポジトリとは、ファイルとそのファイルに加えられた変更の履歴のコレクションです。Git は、特定の時点でのファイルのスナップショットであるコミットを通じて変更を追跡します。
git-playground リポジトリの構造を見てみましょう。
ls -la以下のファイルが表示されるはずです。
README.md - リポジトリのドキュメントfile1.txt - サンプルテキストファイルfile2.txt - もう一つのサンプルテキストファイルGit でコミット履歴を表示するための最も基本的なコマンドはgit logです。このコマンドは、コミット履歴を逆時系列順（最新のコミットが最初）に表示します。
試してみましょう。
git log以下のような出力が表示されるはずです。
commit d22f46ba8c2d4e07d773c5126e9c803933eb5898 (HEAD -> master, origin/master, origin/main, origin/feature-branch, origin/HEAD)
Author: Hang <huhuhang@users.noreply.github.com>
Date: Wed Apr 26 14:16:25 2023 +0800
Added file2.txt
commit cf80005e40a3c661eb212fcea5fad06f8283f08f
Author: Hang <huhuhang@users.noreply.github.com>
Date: Wed Apr 26 14:16:25 2023 +0800
Added file1.txt
commit b00b9374a7c549d1af111aa777fdcc868d8a2a01
Author: Hang <huhuhang@users.noreply.github.com>
Date: Wed Apr 26 14:16:00 2023 +0800
Initial commit各コミットのエントリには以下が表示されます。
より簡潔な表示にするには、--onelineオプションを使用できます。
git log --onelineこれにより、各コミットが 1 行に表示され、短いコミットハッシュとコミットメッセージのみが表示されます。
d22f46b Added file2.txt
cf80005 Added file1.txt
b00b937 Initial commitこれらの基本的なログコマンドは、現在のブランチの履歴を理解するのに役立ちます。次のステップでは、リモートブランチに関する情報を表示する方法を学びます。
このステップでは、リモートリポジトリと Git でそれらをどのように扱うかについて学びます。
リモートリポジトリとは、インターネットや他のネットワーク上でホストされているプロジェクトのバージョンです。他の人と共同作業を行う場合、変更をリモートリポジトリにプッシュし、相手の変更をリモートリポジトリからプルします。
今回のケースでは、GitHub 上のhttps://github.com/labex-labs/git-playground.gitにホストされているリモートリポジトリがあります。このリモートは、ローカルリポジトリにoriginという名前で既に設定されています。
設定されているリモートリポジトリを確認するには、以下を使用します。
git remote -v以下のような出力が表示されるはずです。
origin https://github.com/labex-labs/git-playground.git (fetch)
origin https://github.com/labex-labs/git-playground.git (push)リモートブランチは、リモートリポジトリ内のブランチの状態を表します。これらは<remote-name>/<branch-name>という命名規則に従っており、例えばorigin/masterやorigin/feature-branchなどがあります。
リモートブランチを含むすべてのブランチを表示するには、以下を使用します。
git branch -a出力にはローカルブランチとリモートブランチの両方が表示されるはずです。
* master
remotes/origin/HEAD -> origin/master
remotes/origin/feature-branch
remotes/origin/main
remotes/origin/masterリモートブランチのコミット履歴を表示できるようになる前に、リモートリポジトリから最新のデータをフェッチする必要があります。これにより、変更をマージすることなく、ローカルのリモートブランチのコピーが更新されます。
最新のデータをフェッチしましょう。
git fetch originこのコマンドは、リモートリポジトリから最新のコミット、ブランチ、ファイルをすべてダウンロードし、リモートブランチの最新の状態を表示できるようにします。
これで、リモートブランチ名を指定してgit logを使用してリモートブランチのコミット履歴を表示できます。
git log origin/feature-branchこのリポジトリのすべてのブランチが同じコミットを指しているため、同じコミット履歴が表示されます。
commit d22f46ba8c2d4e07d773c5126e9c803933eb5898 (HEAD -> master, origin/master, origin/main, origin/feature-branch, origin/HEAD)
Author: Hang <huhuhang@users.noreply.github.com>
Date: Wed Apr 26 14:16:25 2023 +0800
Added file2.txt
commit cf80005e40a3c661eb212fcea5fad06f8283f08f
Author: Hang <huhuhang@users.noreply.github.com>
Date: Wed Apr 26 14:16:25 2023 +0800
Added file1.txt
commit b00b9374a7c549d1af111aa777fdcc868d8a2a01
Author: Hang <huhuhang@users.noreply.github.com>
Date: Wed Apr 26 14:16:00 2023 +0800
Initial commitリモートリポジトリを理解し、そこからデータをフェッチする方法を学ぶことで、任意のリモートブランチのコミット履歴にアクセスして表示することができます。
リモートブランチの履歴を表示する基本を理解したので、コミット履歴をより良く視覚化し分析するための、より高度な Git ログオプションを探求しましょう。
git logコマンドには、出力をカスタマイズするための多くのオプションがあります。以下にいくつかの便利なオプションを示します。
コミット履歴をよりコンパクトに表示するには、--onelineオプションを使用します。
git log --oneline origin/master出力例：
d22f46b Added file2.txt
cf80005 Added file1.txt
b00b937 Initial commit特定の数のコミットのみを表示したい場合は、-nオプションの後に数値を指定します。
git log -n 2 origin/masterこれにより、リモートの master ブランチの最新 2 つのコミットのみが表示されます。
各コミットで行われた実際の変更を表示するには、-pオプション（"patch"の略）を追加します。
git log -p origin/masterこれにより、追加または削除された行を含む、各コミットの完全な diff が表示されます。これは、バグを調査したり、特定の変更を理解したりする際に特に役立ちます。
特定のファイルでこれを試してみましょう。
git log -p origin/master -- file1.txtこのコマンドは、リモートの master ブランチのfile1.txtファイルのみに対する変更を含むコミット履歴を表示します。
コミット履歴の視覚的な表現を得るには、--graphオプションを使用します。
git log --graph --oneline --allこれにより、コミットとブランチの関係を示す ASCII グラフが表示されます。
* d22f46b (HEAD -> master, origin/master, origin/main, origin/feature-branch, origin/HEAD) Added file2.txt
* cf80005 Added file1.txt
* b00b937 Initial commitグラフは、ブランチがどのように分岐し、マージされるかを視覚化するのに役立ち、プロジェクトの開発履歴を理解しやすくします。
各コミットでの変更に関する統計を表示するには：
git log --stat origin/masterこれにより、どのファイルが変更されたか、および各コミットで何行が追加または削除されたかが表示されます。
これらの高度なログコマンドは、さまざまな方法でリモートブランチのコミット履歴を分析および理解するための強力なツールを提供します。
リモートブランチのコミット履歴を表示できるようになったので、ブランチを比較し、特定のコミットをより詳細に調査する方法を学びましょう。
Git は、異なるブランチを比較するための強力なツールを提供します。私たちの git-playground リポジトリではすべてのブランチが同じコミットを指しているため、まずこれらのコマンドの使用方法を理解し、次に実践的な例を見てみましょう。
現在のブランチとリモートブランチとの違いを表示するには、以下を使用します。
git diff origin/mainこの例ではすべてのブランチが同一であるため、違いは表示されません。しかし、実際のプロジェクトでは、これは現在のブランチとリモートブランチの間で何が変更されたかを示します。
2 つのリモートブランチを比較することもできます。
git diff origin/master origin/feature-branchここでも、同一であるため違いは表示されません。
特定のコミットを詳細に調査する必要がある場合があります。これは、git showコマンドの後にコミットハッシュを指定することで実行できます。
まず、コミットハッシュを取得しましょう。
git log --oneline origin/master次に、ハッシュを使用して特定のコミットを調査します。
git show d22f46bこのコマンドは、コミットの詳細とそのコミットで導入された変更を表示します。file2.txtの追加が表示されます。
file1.txtを追加したコミットを調査してみましょう。
git show cf80005そして初期コミットです。
git show b00b937リモートブランチに存在する特定のファイルのコンテンツを表示するには、以下を使用します。
git show origin/master:README.mdこれにより、リモートリポジトリの master ブランチに存在するREADME.mdのコンテンツが表示されます。
他のファイルのコンテンツを表示することもできます。
git show origin/master:file1.txt
git show origin/master:file2.txt特定のファイルを誰がいつ変更したかを確認するには、git blameコマンドを使用します。
git blame README.mdこれにより、ファイルの各行と、その行に対する最後の変更のコミットハッシュ、作成者、日付が表示されます。
他のファイルでも試してみてください。
git blame file1.txt
git blame file2.txt特定のファイルが時間とともにどのように進化してきたかを確認するには、以下を使用します。
git log -p origin/master -- README.mdこれにより、リモート master ブランチのREADME.mdファイルを変更したすべてのコミットと、各コミットで行われた変更が表示されます。
これらのコマンドは、コードベースの履歴と進化を理解するための貴重なツールを提供し、変更の追跡、問題のデバッグ、他の開発者との共同作業を容易にします。
リモートブランチ履歴を表示する技術的な側面を学んだので、実際の開発シナリオでこの知識をどのように実践的に応用できるかを探求しましょう。
チームメンバーが行ったコードの変更をレビューする際には、以下を使用できます。
git log -p origin/masterこれにより、メインブランチにマージする前に変更を包括的に理解することができます。私たちの git-playground の例では、各ファイルがいつどのように追加されたかを正確に見ることができます。
アプリケーションにバグが発生した場合、それがいつ導入されたかを追跡できます。例えば、特定のファイルに問題があった場合：
git log -p origin/master -- file1.txt特定のファイルのコミット履歴を調べることで、問題のあるコードがいつ、なぜ追加されたかを特定できます。
プロジェクトの開発進捗を理解するには：
git log --oneline origin/masterこれにより、プロジェクトに貢献したコミットの時系列ビューが得られます。私たちの例では：
d22f46b Added file2.txt
cf80005 Added file1.txt
b00b937 Initial commitプロジェクトが初期コミットから進化し、その後 2 つのファイルが順番に追加されたことがわかります。
特定のファイルまたはコードベースの領域に誰が貢献したかを確認するには：
git shortlog -sn origin/masterこれにより、貢献者とそのコミット数の概要が表示されます。
3 Hang特定のファイルの場合：
git shortlog -sn origin/master -- README.mdプロジェクトがどのように進化してきたかを理解する必要があると想像してください。これらのコマンドを試してください。
git log --oneline --graph --allgit log --stat origin/mastergit log -p origin/mastergit log -1 --format="%H %an %ad %s" origin/master -- file2.txtgit show cf80005:. | head -10私たちのリポジトリではすべてのブランチが同じコミットを指しているため、これが何を意味するかを理解しましょう。
git show-branch origin/master origin/main origin/feature-branchこれにより、すべてのブランチが同じ状態にあることが示されます。これは、単純なリポジトリやブランチが同期されている場合に一般的です。
すべてリモート参照を表示するには：
git ls-remote originこれにより、リモートリポジトリで利用可能なすべてのブランチとタグが表示されます。
これらの実践的な例は、リモートブランチ履歴を表示することで、コードベースの進化を理解し、チームメンバーとより効果的に協力し、問題をより効率的に解決する方法を示しています。
この実験でカバーされたスキルを習得することで、プロの開発環境で Git を操作し、ソフトウェアプロジェクトで効果的に協力するための準備が整います。
この実験では、実際の GitHub リポジトリ（git-playground）を使用してリモート Git ブランチのコミット履歴を表示および分析する方法を学びました。これは、ソフトウェア開発プロジェクトにおける効果的なコラボレーションに不可欠なスキルです。
カバーされた主なポイント：
git logによる基本的なコミット履歴の理解git-playground リポジトリを操作することで、以下のことを確認しました。
これらのスキルにより、以下のことが可能になります。
Git を使い続けるにつれて、これらの能力はますます価値のあるものとなり、複雑なコードベースをナビゲートし、共同開発プロジェクトに効果的に貢献するのに役立ちます。
