チャプター ▾ 第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

このオプションは同じ情報を表示しますが、各エントリの直後に差分が表示されます。これは、コードレビューや、共同作業者が追加した一連のコミット中に何が起こったかを素早く確認するのに非常に役立ちます。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個のコミットを表示します。実際には、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個のコミットのみを表示します。

--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