Git 入门：第一次用 git log 看懂项目历史

刚学 Git 的时候，我最怕的不是提交代码，而是看不懂项目历史。打开一个接手来的仓库，文件一堆，却不知道谁改了什么、什么时候改的、为什么这样改。后来我发现，git log 就是这个项目的“大事记”，学会读它，等于拿到了一张项目地图。

先跑一次最简单的 git log

在项目目录里输入 git log，回车之后会看到一串提交记录，默认按时间倒序排列，最新的在最上面。每一条提交一般包含四样东西：提交的哈希值、作者、提交日期，和提交说明。哈希值像提交的身份证号，前面七位通常就足够定位到某一次提交。第一次看不用全读懂，先扫一遍提交说明，就能知道这个项目最近在忙什么。

让历史变短变清楚

默认的 git log 有点啰嗦，几条记录就能占满一屏。加上 --oneline 参数，每条提交只剩一行：哈希前七位加上一句说明，一屏能看十几条，找东西快得多。再加 -n 10，就只看最近十条。想看分支怎么分叉合并，可以试试 git log --graph --all，配合 --oneline，分支的走向会画成一棵小树，哪里分叉、哪里合并一目了然。

按时间、按人缩小范围

项目历史一长，全看既费时间也抓不住重点。这时可以加过滤条件：–since=“2026-11-01” 只看十一月以来的提交，–author=“小明” 只看某个人的提交。刚接手项目时，我喜欢先看最近一个月的记录，再挑一个最活跃的作者，看他连续改了哪些文件，基本就能摸清项目当前的主线。

读懂一条提交，再看具体改动

一条好的提交说明会说清楚两件事：做了什么，以及为什么这样做。比如“修复登录页在弱网下重复提交的问题”，比“改了点东西”有用得多。看到感兴趣的提交，记下它的哈希前七位，再跑 git show 加上这个哈希，就能看到那次提交具体改了哪些文件、哪些行。配合 git diff 一起看，提交说明里的“为什么”和代码里的“怎么做”就对上了。

给新手的三条建议

第一，提交时把说明写清楚，动词开头、每次只做一件事，未来的自己和队友都会感谢你。第二，养成先读 log 再动手改代码的习惯，改之前知道这段代码经历过什么，就不容易踩前人踩过的坑。第三，别怕翻历史，git log 只是读记录，不会改动仓库，放心翻。

今天花十分钟，把自己项目的 git log 翻一遍：先看最近十条，再挑一条用 git show 看细节。你会发现，那些曾经陌生的文件名和提交说明，慢慢连成了一条看得懂的故事线。读懂历史，是用好 Git 的第一步。