如何查看提交历史记录？

掌握如何高效地在繁杂的提交日志中穿梭，是每个开发者的基本功。其实，无论是习惯使用命令行的效率极客，还是偏爱图形化界面的视觉派，都有适合自己的方法。本文将从几个常见的工作场景出发，为你同时提供命令行与图形化两种解决方案。

查看最近的提交记录

这是最基础的需求，比如快速了解项目当前分支的最新动态。

命令行方案：git log 基础用法

在终端里，最直接的命令就是 git log。它会按时间倒序列出所有的提交记录。

git log

每一条记录都包含了唯一的哈希值（commit hash）、作者、提交日期和提交信息。如果觉得信息太多，可以使用 --oneline 参数，它会将每条提交压缩到一行，只显示哈希值和提交信息，非常清爽。

git log --oneline

图形化界面方案：一眼看全

对于使用图形化工具（如 Sourcetree、VS Code 自带的 Git 插件）或代码托管平台（如 GitHub、GitLab）的用户来说，查看提交历史通常是默认功能。打开工具或项目页面，提交历史、分支图谱会直观地展现在你面前，你甚至不需要任何操作。这种方式对于理解复杂的分支合并关系尤其有帮助。

查找特定作者或时间范围的提交

当你想回顾自己上周的工作，或者需要审查某位同事在特定时间段内的代码提交时，精确筛选就显得尤为重要。

命令行方案：精准筛选

git log 提供了强大的筛选参数。

要查找特定作者的提交，使用 --author 参数：

git log --author="John Doe"

要查找特定时间段的提交，可以使用 --since (或 --after) 和 --until (或 --before)：

# 查看最近两周的提交
git log --since="2 weeks ago"
# 查看指定日期之后的所有提交
git log --after="2023-11-01"

这些参数可以组合使用，实现更精确的定位，比如查找张三在 11 月份的所有提交。

图形化界面方案：点击与筛选

几乎所有的图形化工具都在界面上提供了筛选功能。通常会有一个搜索框或几个下拉菜单，让你直接选择或输入作者名字、选择日期范围，然后提交列表会自动刷新，显示出符合条件的结果。这比在命令行里记忆和拼接参数要直观得多。

查看某个文件或目录的变更历史

排查问题时，我们常常需要针对某一个特定的文件进行“考古”，看看它都经历了哪些修改。

命令行方案：追溯源头

要查看某个文件的历史，只需在 git log 命令后附上文件路径。

git log -- src/components/Login.vue

这条命令会只显示那些修改了 src/components/Login.vue 文件的提交记录。

如果你还想看到每一次修改的具体代码变动（diff），可以加上 -p 或 --patch 参数。

git log -p -- src/components/Login.vue

图形化界面方案：右键直达

这可能是图形化界面最便捷的操作之一。在文件列表中找到目标文件，通常只需要右键点击，在弹出的菜单中选择“查看历史”或“Log Selected...”之类的选项，工具就会立刻为你筛选出该文件的所有相关提交。

通过关键词搜索提交信息

有时候，我们不记得作者和时间，只模糊记得提交信息里包含某个关键词，比如“修复登录 bug”。

命令行方案：--grep 大显身手

--grep 参数专门用于在提交信息中进行搜索。

git log --grep="修复登录"

这个命令会找出所有提交信息中包含“修复登录”这几个字的记录。默认情况下，搜索是区分大小写的。如果想进行不区分大小写的搜索，可以加上 -i 参数。

图形化界面方案：善用搜索框

图形化工具和网页平台的搜索功能通常是全局的。你在顶部的搜索框输入关键词，它不仅会搜索提交信息，还可能同时搜索作者、文件名甚至代码内容。这在信息不完整时，能提供更广泛的搜索结果。

进阶技巧：格式化你的日志输出

虽然 git log --oneline 已经很方便，但我们还可以通过自定义格式，让输出信息更符合自己的阅读习惯，甚至加上颜色和分支图。

--graph 参数可以在日志旁用 ASCII 字符绘制出分支的合并与分叉情况，非常直观。

git log --graph --oneline

更进一步，我们可以使用 --pretty=format 来自定义输出格式。下面这个例子是我个人很喜欢的一个配置，它包含了颜色、缩短的哈希值、分支信息、相对时间、作者等关键信息，并且带有分支图。

git log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset'

你可以将这个复杂的命令设置为一个 Git alias，比如 git lg，之后就可以用一个简短的命令唤出这个漂亮的日志了。

总结：选择适合你的工具

在查看 Git 提交历史这件事上，命令行和图形化界面并非对立关系，而是互补的。

• 命令行：它提供了无与伦比的灵活性和自动化能力。当你需要进行复杂的组合查询、在服务器上操作或将日志结果通过管道传递给其他命令处理时，命令行是唯一的选择。
• 图形化界面：它的优势在于直观。对于快速概览项目全貌、理解复杂的分支结构，或者向不熟悉 Git 的同事演示变更历史时，图形化界面无疑效率更高。

聪明的开发者通常会两者兼用：用图形化工具进行日常的快速浏览和代码审查，而在需要精确、复杂的历史追溯时，则毫不犹豫地打开终端。关键在于理解你的场景，然后选择当下最高效的那个工具。