Git笔记(29) 搜索


1. 浏览代码和提交

无论仓库里的代码量有多少
经常需要查找一个函数是在哪里调用或者定义的,或者一个方法的变更历史
Git 提供了两个有用的工具来快速地从它的数据库中浏览代码和提交


2. Git Grep

Git 提供了一个 grep 命令,可以很方便地从提交历史或者工作目录中查找一个字符串或者正则表达式

用 Git 本身源代码的查找作为例子
默认情况下 Git 会查找工作目录的文件
可以传入 -n 参数来输出 Git 所找到的匹配行行号

$ 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

还有一些有趣的选项
例如,可以使用 --count 选项来使 Git 输出概述的信息
仅仅包括哪些文件包含匹配以及每个文件包含了多少个匹配

$ 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

如果想看匹配的行是属于哪一个方法或者函数,可以传入 -p 选项:

$ 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_numbermatch_digit 两个函数调用了 gmtime_r

还可以使用 --and 标志来查看复杂的字符串组合,也就是在同一行同时包含多个匹配
比如,查看在旧版本 1.8.0 的 Git 代码库中定义了常量名包含 “LINK” 或者 “BUF_MAX” 这两个字符串所在的行
这里也用到了 --break--heading 选项来使输出更加容易阅读

$ 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 */

相比于一些常用的搜索命令比如 grepackgit grep 命令有一些的优点
第一就是速度非常快
第二是不仅仅可以可以搜索工作目录,还可以搜索任意的 Git 树
在上一个例子中,在一个旧版本的 Git 源代码中查找,而不是当前检出的版本


3. Git 日志搜索

或许不想知道某一项在哪里 ,而是想知道是什么时候存在或者引入的
git log 命令有许多强大的工具可以通过提交信息
甚至是 diff 的内容来找到某个特定的提交

例如,如果想找到 ZLIB_BUF_MAX 常量是什么时候引入的
可以使用 -S 选项来显示新增和删除该字符串的提交

$ 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 这个提交引入了常量
并且在 e01503b 这个提交中被修改了

如果希望得到更精确的结果,可以使用 -G 选项来使用正则表达式搜索


4. 行日志搜索

行日志搜索是另一个相当高级并且有用的日志搜索功能
git log 后加上 -L 选项即可调用,它可以展示代码中一行或者一个函数的历史

例如,假设想查看 zlib.c 文件中 git_deflate_bound 函数的每一次变更
可以执行 git log -L :git_deflate_bound:zlib.c
Git 会尝试找出这个函数的范围,然后查找历史记录
并且显示从函数创建之后一系列变更对应的补丁

$ 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 无法计算出如何匹配代码中的函数或者方法,可以提供一个正则表达式
例如,这个命令和上面的是等同的:

$ git log -L '/unsigned long git_deflate_bound/',/^}/:zlib.c

也可以提供单行或者一个范围的行号来获得相同的输出


参考: git
以上内容,均根据git官网介绍删减、添加和修改组成


相关推荐:

Git笔记(28) 签署工作
Git笔记(27) 储藏与清理
Git笔记(26) 交互式暂存
Git笔记(25) 选择修订版本
Git笔记(24) 维护项目


谢谢

氢键H-H CSDN认证博客专家 机器人软件 运动控制 深度学习
一位永远相信美好的事情即将发生,从事自动化机器人软件开发,不忘初心,牢记使命,为实现中华民族伟大复兴而奋斗的社会主义接班人。
©️2020 CSDN 皮肤主题: 我行我“速” 设计师:Amelia_0503 返回首页
实付 49.90元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值