Git
章 ▾ 第2版

2.3 Gitの基本 - コミット履歴の表示

コミット履歴の表示

いくつかのコミットを作成した後、または既存のコミット履歴を持つリポジトリをクローンした場合、何が起こったかを確認するために振り返ってみたくなるでしょう。これを行うための最も基本的で強力なツールは、git logコマンドです。

これらの例では、「simplegit」と呼ばれる非常にシンプルなプロジェクトを使用します。プロジェクトを入手するには、以下を実行します。

$ git clone https://github.com/schacon/simplegit-progit

このプロジェクトでgit logを実行すると、次のような出力が得られるはずです。

$ git log
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 16:40:33 2008 -0700

    Remove unnecessary test

commit a11bef06a3f659402fe7563abf99ad00de2209e6
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 10:31:28 2008 -0700

    Initial commit

デフォルトでは、引数なしでgit logは、そのリポジトリで行われたコミットを逆時系列順にリストします。つまり、最も新しいコミットが最初に表示されます。ご覧のとおり、このコマンドは各コミットをSHA-1チェックサム、作成者の名前とメール、作成日、およびコミットメッセージとともにリストします。

git logコマンドには、探しているものを正確に表示するための非常に多くのオプションが用意されています。ここでは、最も一般的なものをいくつか紹介します。

より役立つオプションの1つは、-pまたは--patchで、各コミットで導入された差分（*パッチ*出力）を表示します。また、-2を使用して最後の2つのエントリのみを表示するなど、表示するログエントリの数を制限することもできます。

$ git log -p -2
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

diff --git a/Rakefile b/Rakefile
index a874b73..8f94139 100644
--- a/Rakefile
+++ b/Rakefile
@@ -5,7 +5,7 @@ require 'rake/gempackagetask'
 spec = Gem::Specification.new do |s|
     s.platform  =   Gem::Platform::RUBY
     s.name      =   "simplegit"
-    s.version   =   "0.1.0"
+    s.version   =   "0.1.1"
     s.author    =   "Scott Chacon"
     s.email     =   "schacon@gee-mail.com"
     s.summary   =   "A simple gem for using Git in Ruby code."

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 16:40:33 2008 -0700

    Remove unnecessary test

diff --git a/lib/simplegit.rb b/lib/simplegit.rb
index a0a60ae..47c6340 100644
--- a/lib/simplegit.rb
+++ b/lib/simplegit.rb
@@ -18,8 +18,3 @@ class SimpleGit
     end

 end
-
-if $0 == __FILE__
-  git = SimpleGit.new
-  puts git.show
-end

このオプションは、同じ情報を表示しますが、各エントリの直後にdiffが付いています。これは、コードレビューや、共同作業者が追加した一連のコミット中に何が起こったかをすばやく確認するのに非常に役立ちます。また、git logで一連の要約オプションを使用することもできます。たとえば、各コミットの要約統計を表示する場合は、--statオプションを使用できます。

$ git log --stat
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

    Change version number

 Rakefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 16:40:33 2008 -0700

    Remove unnecessary test

 lib/simplegit.rb | 5 -----
 1 file changed, 5 deletions(-)

commit a11bef06a3f659402fe7563abf99ad00de2209e6
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 10:31:28 2008 -0700

    Initial commit

 README           |  6 ++++++
 Rakefile         | 23 +++++++++++++++++++++++
 lib/simplegit.rb | 25 +++++++++++++++++++++++++
 3 files changed, 54 insertions(+)

ご覧のとおり、--statオプションは、各コミットエントリの下に、変更されたファイルのリスト、変更されたファイル数、およびそれらのファイルに追加および削除された行数を表示します。また、最後に情報の要約を表示します。

もう1つの非常に便利なオプションは--prettyです。このオプションは、ログ出力をデフォルト以外の形式に変更します。このオプションで使用できるいくつかの事前構築済みのオプション値があります。このオプションのoneline値は、各コミットを1行で出力します。これは、多数のコミットを見ている場合に役立ちます。さらに、short、full、およびfullerの値は、ほぼ同じ形式で出力を表示しますが、それぞれ情報が少なくなったり、多くなったりします。

$ git log --pretty=oneline
ca82a6dff817ec66f44342007202690a93763949 Change version number
085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7 Remove unnecessary test
a11bef06a3f659402fe7563abf99ad00de2209e6 Initial commit

最も興味深いオプション値はformatで、これを使用すると独自のログ出力形式を指定できます。これは、マシン解析用の出力を生成する場合に特に役立ちます。形式を明示的に指定するため、Gitの更新によって形式が変わることはありません。

$ git log --pretty=format:"%h - %an, %ar : %s"
ca82a6d - Scott Chacon, 6 years ago : Change version number
085bb3b - Scott Chacon, 6 years ago : Remove unnecessary test
a11bef0 - Scott Chacon, 6 years ago : Initial commit

git log --pretty=formatで使用できる便利な指定子には、formatが受け入れる便利な指定子がいくつかリストされています。

表1. git log --pretty=formatで使用できる便利な指定子
指定子 出力の説明

%H

コミットハッシュ

%h

短縮されたコミットハッシュ

%T

ツリーハッシュ

%t

短縮されたツリーハッシュ

%P

親ハッシュ

%p

短縮された親ハッシュ

%an

著者名

%ae

著者のメールアドレス

%ad

著者の日付（形式は--date=optionに従います）

%ar

著者の日付（相対的）

%cn

コミッター名

%ce

コミッターのメールアドレス

%cd

コミッターの日付

%cr

コミッターの日付（相対的）

%s

件名

著者とコミッターの違いは何だろうと思っているかもしれません。著者はもともと作業を書いた人であり、コミッターは最後に作業を適用した人です。そのため、プロジェクトにパッチを送信し、コアメンバーの1人がパッチを適用すると、あなたもコアメンバーも両方ともクレジットされます。あなたは著者として、コアメンバーはコミッターとしてクレジットされます。この区別については分散Gitで詳しく説明します。

onelineおよびformatのオプション値は、--graphという別のlogオプションを使用すると特に便利です。このオプションは、ブランチとマージの履歴を示す小さなASCIIグラフを追加します。

$ git log --pretty=format:"%h %s" --graph
* 2d3acf9 Ignore errors from SIGCHLD on trap
*  5e3ee11 Merge branch 'master' of https://github.com/dustin/grit.git
|\
| * 420eac9 Add method for getting the current branch
* | 30e367c Timeout code and tests
* | 5a09431 Add timeout protection to grit
* | e1193f8 Support for heads with slashes in them
|/
* d6016bc Require time for xmlschema
*  11d191e Merge branch 'defunkt' into local

このタイプの出力は、次の章でブランチとマージについて説明するにつれて、より興味深くなります。

これらはgit logに対するいくつかの簡単な出力形式オプションにすぎません。他にも多くのオプションがあります。git logの一般的なオプションには、これまで説明したオプションや、役立つ可能性のある他の一般的な形式オプション、およびlogコマンドの出力をどのように変更するかがリストされています。

表2. git logの一般的なオプション
オプション 説明

-p

各コミットで導入されたパッチを表示します。

--stat

各コミットで変更されたファイルの統計情報を表示します。

--shortstat

--statコマンドから変更/挿入/削除行のみを表示します。

--name-only

コミット情報の後に、変更されたファイルのリストを表示します。

--name-status

追加/変更/削除情報とともに、影響を受けたファイルのリストも表示します。

--abbrev-commit

SHA-1チェックサム全体（40文字）ではなく、最初の数文字だけを表示します。

--relative-date

完全な日付形式を使用する代わりに、相対形式（たとえば、「2週間前」）で日付を表示します。

--graph

ログ出力の横に、ブランチとマージの履歴のASCIIグラフを表示します。

--pretty

代替形式でコミットを表示します。オプション値には、oneline、short、full、fuller、およびformat（独自の形式を指定する場合）が含まれます。

--oneline

--pretty=oneline --abbrev-commitを一緒に使用する場合の省略形です。

ログ出力の制限

出力形式オプションに加えて、git logは多くの便利な制限オプションを受け入れます。つまり、コミットのサブセットのみを表示できるオプションです。すでにそのようなオプションを1つ見てきました。最後の2つのコミットのみを表示する-2オプションです。実際には、-<n>を実行できます。ここで、nは最後のn個のコミットを表示する任意の整数です。実際には、Gitはデフォルトですべての出力をページャーに通すため、一度にログ出力の1ページしか表示されないため、それほど頻繁に使用することはありません。

ただし、--sinceや--untilなどの時間制限オプションは非常に役立ちます。たとえば、このコマンドは、過去2週間に作成されたコミットのリストを取得します。

$ git log --since=2.weeks

このコマンドは多くの形式で機能します。"2008-01-15"のような特定の日付、または"2 years 1 day 3 minutes ago"のような相対日付を指定できます。

リストをフィルタリングして、一部の検索条件に一致するコミットにすることもできます。--authorオプションを使用すると特定の著者でフィルタリングでき、--grepオプションを使用するとコミットメッセージ内のキーワードを検索できます。

注意

--authorおよび--grep検索条件の両方のインスタンスを複数指定できます。これにより、コミット出力はいずれかの--authorパターンといずれかの--grepパターンに一致するコミットに制限されます。ただし、--all-matchオプションを追加すると、出力はすべての--grepパターンに一致するコミットのみに制限されます。

もう1つの非常に役立つフィルターは-Sオプション（一般的にGitの「つるはし」オプションと呼ばれます）で、文字列を受け取り、その文字列の出現回数を変更したコミットのみを表示します。たとえば、特定の関数への参照を追加または削除した最後のコミットを見つけたい場合は、次のように呼び出すことができます。

$ git log -S function_name

フィルターとしてgit logに渡す最後の本当に便利なオプションはパスです。ディレクトリまたはファイル名を指定すると、ログ出力をそれらのファイルへの変更を導入したコミットに制限できます。これは常に最後のオプションであり、通常はパスをオプションから分離するために二重ダッシュ（--）が前に付けられます。

$ git log -- path/to/file

git logの出力を制限するオプションでは、これらのオプションと、参照用の他の一般的なオプションをいくつかリストします。

表3. git logの出力を制限するオプション
オプション 説明

-<n>

最後のn個のコミットのみを表示します。

--since、--after

指定された日付より後に作成されたコミットに制限します。

--until、--before

指定された日付より前に作成されたコミットに制限します。

--author

著者エントリが指定された文字列に一致するコミットのみを表示します。

--committer

コミッターエントリが指定された文字列に一致するコミットのみを表示します。

--grep

コミットメッセージに文字列を含むコミットのみを表示します。

-S

文字列に一致するコードを追加または削除するコミットのみを表示します。

たとえば、Gitソースコード履歴のテストファイルを変更するコミットのうち、2008年10月にJunio Hamanoによってコミットされ、マージコミットではないものを表示したい場合は、次のようなものを実行できます。

$ git log --pretty="%h - %s" --author='Junio C Hamano' --since="2008-10-01" \
   --before="2008-11-01" --no-merges -- t/
5610e3b - Fix testcase failure when extended attributes are in use
acd3b9e - Enhance hold_lock_file_for_{update,append}() API
f563754 - demonstrate breakage of detached checkout with symbolic link HEAD
d1a43f2 - reset --hard/read-tree --reset -u: remove unmerged new paths
51a94af - Fix "checkout --track -b newbranch" on detached HEAD
b0ad11e - pull: allow "git pull origin $something:$current_branch" into an unborn branch

Gitソースコード履歴の約40,000件のコミットのうち、このコマンドはこれらの条件に一致する6件を表示します。

ヒント
マージコミットの表示を防止する

リポジトリで使用されるワークフローによっては、ログ履歴のコミットのかなりの割合が単なるマージコミットである可能性があり、通常はあまり有益ではありません。ログ履歴を乱雑にするマージコミットの表示を防止するには、logオプション--no-mergesを追加するだけです。
scroll-to-top