项目关键字查找_如何使用Git掌控项目

背景

作为开发者，我们都需要使用Git。无论是开源项目，还是企业项目，我们都需要回溯历史变动。查询某个功能是什么时候添加的，我们想查看它的演变就可以了（因为Git就是按照时间轴标记commit的）。

如何使用git回溯历史

如果从项目中，找到某个变量，但是想知道这个变量的所有commit信息

这时我们就可以使用下面g代码it log进行搜索

git log -S '关键字'

这些commit是从最晚到最早提交进行排序的结果列表，这样可以查看最近的'关键字'变动

如果对git log 非常熟悉的，就不用往下看了。。我是想记录一些自己的感想，认为对工作，对个人提升有帮助的点。

基于git log的技巧

问题1:我们有时候，就是不知道这个变量是怎么来的，无法了解它的逻辑和实现

猜想：如果我们能从项目中，寻找这个变量，是从那个commit开始提交的，这样我们是不是就可以回溯它的演变了？（包括阅读开源项目）

git log --reverse -S '关键字'

比如我想查看v-on在vue中的实现，第一个想到的是使用编辑器或者grep/rg全局搜索。

因为Vue项目基于git，我们有更好的方式（不用全局搜索），那就是把问题转换为寻找第一个含有'v-on'的commit记录，然后从中探索它的实现过程

git log --reverse -S 'v-on'

效果图：

可是这样子还是不够友好，因为并没有列出包含'v-on'的记录到底在文件中哪里，仅仅列出了commit信息

所以我们可以给 git log 添加 -p参数，让记录直接输出到stdout，然后我们可以继续添加grep进行关键字过滤结果

git log --reverse -p -S 'v-on' | grep -iE "(^commitb|^diffb|v-on)" -A 3 -B 3 -m 30

-m是为了避免记录过多，限制加载次数。再git checkout 到最后一个commit，就可以继续查看记录（大工程频繁git checkout很慢）

git log --reverse -p -S 'v-on' <上一次最后输出的commit hash>..<最新的commit hash或者分支名字> | grep -iE "(^commitb|^diffb|v-on)" -A 3 -B 3 -m 30（-m 是限制匹配输出30次，防止过多匹配）

如果有些文件是在一行过长，可以用rg -M 限制一行的byte大小，这样过长的一行就会被跳过
git log --reverse -p -S 'v-on' <上一次最后输出的commit hash>..<最新的commit hash或者分支名字> | rg -e "(^commitb|^diffb|v-on)" -A 3 -B 3 -M 500

如果有大量的匹配，一时之间停不下来，-m限制匹配出现次数来终止。也可以执行commit的范围来决定匹配，因为我们没法知道关键字都集中在那一个范围，所以这样会有点被动。

取HEAD后的第20个commit hash如下：
git rev-list HEAD..master | tail -20 | head -1
这样把上面的结果，放到前面的<最新的commit hash或者分支名字>,就可以知道范围查找，避免停不下来。

一般来说，可以用git checkout HEAD~1（HEAD向后，也就是向下）
也可以用git checkout head^1 来控制跳到那个父commit（如果当前的commit，有多个合并来源，它可以从多个父来源方向选择一个进行回退）

让HEAD向前，也就是向上移动
git checkout -（类似cd -，返回上一次记录）
git checkout $(git rev-list HEAD..master | tail -1| head -1)（如果要指定向前多少步，修改 tail 的参数）

太幸运了，我们在第一个commit，就看到Vue作者写的v-on正则，并且是|和@连接，所以@和v-on是同一个匹配规则，就是这么来的。

接下来我们就可以继续翻阅v-on的相关代码演进，这里就不演示了

除了-S之外，使用-G参数让git log支持正则

git log --reverse -G 'v-on'

问题2：如果我是不太明白这个文件中的某个函数是怎么演进到目前这个状态逻辑的，怎么办呢？

我们可以使用git log -L追溯某个文件的变动

// 文件中，某段范围的演变记录回溯
git log -L <开始行号>,<结束行号>:<文件路径>
// 按函数名追溯(有时候不使用,可能跟语法词法有关需要合适的语言)
git log -L :<函数名>:<文件路径>
// 整个文件记录回溯
git log --follow <文件路径>

这个我就不展示了，可以自己尝试，结合grep或者rg获取关键字的位置

git reflog查看git所有操作记录

使用 git reflog，可以查看一些本地git的操作日志

持续完善