7.5 搜索

搜索

無論倉庫里的代碼量有多少，你經(jīng)常需要查找一個(gè)函數(shù)是在哪里調(diào)用或者定義的，或者一個(gè)方法的變更歷史。 Git 提供了兩個(gè)有用的工具來快速地從它的數(shù)據(jù)庫中瀏覽代碼和提交。 我們來簡單的看一下。

Git Grep

Git 提供了一個(gè)?grep?命令，你可以很方便地從提交歷史或者工作目錄中查找一個(gè)字符串或者正則表達(dá)式。 我們用 Git 本身源代碼的查找作為例子。

默認(rèn)情況下 Git 會(huì)查找你工作目錄的文件。 你可以傳入?-n?參數(shù)來輸出 Git 所找到的匹配行行號(hào)。

$ git grep -n gmtime_r
compat/gmtime.c:3:#undef gmtime_r
compat/gmtime.c:8:      return git_gmtime_r(timep, &result);
compat/gmtime.c:11:struct tm *git_gmtime_r(const time_t *timep, struct tm *result)
compat/gmtime.c:16:     ret = gmtime_r(timep, result);
compat/mingw.c:606:struct tm *gmtime_r(const time_t *timep, struct tm *result)
compat/mingw.h:162:struct tm *gmtime_r(const time_t *timep, struct tm *result);
date.c:429:             if (gmtime_r(&now, &now_tm))
date.c:492:             if (gmtime_r(&time, tm)) {
git-compat-util.h:721:struct tm *git_gmtime_r(const time_t *, struct tm *);
git-compat-util.h:723:#define gmtime_r git_gmtime_r

grep?命令有一些有趣的選項(xiàng)。

例如，你可以使用?--count?選項(xiàng)來使 Git 輸出概述的信息，僅僅包括哪些文件包含匹配以及每個(gè)文件包含了多少個(gè)匹配。

$ git grep --count gmtime_r
compat/gmtime.c:4
compat/mingw.c:1
compat/mingw.h:1
date.c:2
git-compat-util.h:2

如果你想看匹配的行是屬于哪一個(gè)方法或者函數(shù)，你可以傳入?-p?選項(xiàng)：

$ git grep -p gmtime_r *.c
date.c=static int match_multi_number(unsigned long num, char c, const char *date, char *end, struct tm *tm)
date.c:         if (gmtime_r(&now, &now_tm))
date.c=static int match_digit(const char *date, struct tm *tm, int *offset, int *tm_gmt)
date.c:         if (gmtime_r(&time, tm)) {

在這里我們可以看到在 date.c 文件中有?match_multi_number?和?match_digit?兩個(gè)函數(shù)調(diào)用了?gmtime_r。

你還可以使用?--and?標(biāo)志來查看復(fù)雜的字符串組合，也就是在同一行同時(shí)包含多個(gè)匹配。 比如，我們要查看在舊版本 1.8.0 的 Git 代碼庫中定義了常量名包含 “LINK” 或者 “BUF_MAX” 這兩個(gè)字符串所在的行。

這里我們也用到了?--break?和?--heading?選項(xiàng)來使輸出更加容易閱讀。

$ git grep --break --heading \
    -n -e '#define' --and \( -e LINK -e BUF_MAX \) v1.8.0
v1.8.0:builtin/index-pack.c
62:#define FLAG_LINK (1u<<20)

v1.8.0:cache.h
73:#define S_IFGITLINK  0160000
74:#define S_ISGITLINK(m)       (((m) & S_IFMT) == S_IFGITLINK)

v1.8.0:environment.c
54:#define OBJECT_CREATION_MODE OBJECT_CREATION_USES_HARDLINKS

v1.8.0:strbuf.c
326:#define STRBUF_MAXLINK (2*PATH_MAX)

v1.8.0:symlinks.c
53:#define FL_SYMLINK  (1 << 2)

v1.8.0:zlib.c
30:/* #define ZLIB_BUF_MAX ((uInt)-1) */
31:#define ZLIB_BUF_MAX ((uInt) 1024 * 1024 * 1024) /* 1GB */

相比于一些常用的搜索命令比如?grep?和?ack，git grep?命令有一些的優(yōu)點(diǎn)。 第一就是速度非常快，第二是你不僅僅可以可以搜索工作目錄，還可以搜索任意的 Git 樹。 在上一個(gè)例子中，我們在一個(gè)舊版本的 Git 源代碼中查找，而不是當(dāng)前檢出的版本。

Git 日志搜索

或許你不想知道某一項(xiàng)在?哪里?，而是想知道是什么?時(shí)候?存在或者引入的。?git log?命令有許多強(qiáng)大的工具可以通過提交信息甚至是 diff 的內(nèi)容來找到某個(gè)特定的提交。

例如，如果我們想找到?ZLIB_BUF_MAX?常量是什么時(shí)候引入的，我們可以使用?-S?選項(xiàng)來顯示新增和刪除該字符串的提交。

$ git log -SZLIB_BUF_MAX --oneline
e01503b zlib: allow feeding more than 4GB in one go
ef49a7a zlib: zlib can only process 4GB at a time

如果我們查看這些提交的 diff，我們可以看到在?ef49a7a?這個(gè)提交引入了常量，并且在e01503b?這個(gè)提交中被修改了。

如果你希望得到更精確的結(jié)果，你可以使用?-G?選項(xiàng)來使用正則表達(dá)式搜索。

行日志搜索

行日志搜索是另一個(gè)相當(dāng)高級(jí)并且有用的日志搜索功能。 這是一個(gè)最近新增的不太知名的功能，但卻是十分有用。 在?git log?后加上?-L?選項(xiàng)即可調(diào)用，它可以展示代碼中一行或者一個(gè)函數(shù)的歷史。

例如，假設(shè)我們想查看?zlib.c?文件中git_deflate_bound?函數(shù)的每一次變更，我們可以執(zhí)行git log -L :git_deflate_bound:zlib.c。 Git 會(huì)嘗試找出這個(gè)函數(shù)的范圍，然后查找歷史記錄，并且顯示從函數(shù)創(chuàng)建之后一系列變更對應(yīng)的補(bǔ)丁。

$ git log -L :git_deflate_bound:zlib.c
commit ef49a7a0126d64359c974b4b3b71d7ad42ee3bca
Author: Junio C Hamano <gitster@pobox.com>
Date:   Fri Jun 10 11:52:15 2011 -0700

    zlib: zlib can only process 4GB at a time

diff --git a/zlib.c b/zlib.c
--- a/zlib.c
+++ b/zlib.c
@@ -85,5 +130,5 @@
-unsigned long git_deflate_bound(z_streamp strm, unsigned long size)
+unsigned long git_deflate_bound(git_zstream *strm, unsigned long size)
 {
-       return deflateBound(strm, size);
+       return deflateBound(&strm->z, size);
 }

commit 225a6f1068f71723a910e8565db4e252b3ca21fa
Author: Junio C Hamano <gitster@pobox.com>
Date:   Fri Jun 10 11:18:17 2011 -0700

    zlib: wrap deflateBound() too

diff --git a/zlib.c b/zlib.c
--- a/zlib.c
+++ b/zlib.c
@@ -81,0 +85,5 @@
+unsigned long git_deflate_bound(z_streamp strm, unsigned long size)
+{
+       return deflateBound(strm, size);
+}
+

如果 Git 無法計(jì)算出如何匹配你代碼中的函數(shù)或者方法，你可以提供一個(gè)正則表達(dá)式。 例如，這個(gè)命令和上面的是等同的：git log -L '/unsigned long git_deflate_bound/',/^}/:zlib.c。 你也可以提供單行或者一個(gè)范圍的行號(hào)來獲得相同的輸出。