版本控制与协作 / 系统课时
查看提交历史
查看提交历史
学习目标
完成本课后,你将能够:
- 使用 git log 查看提交历史
- 掌握简洁、图形化和筛选显示
- 从日志定位目标提交
问题背景或应用场景
项目出现问题或需要理解功能演进时,首先要从提交历史定位相关版本。默认日志信息完整但较长,大型仓库需要结合格式、数量、作者、时间和路径筛选,才能快速获得有效上下文。
核心原理
git log 默认从当前提交沿父提交反向遍历历史。--oneline 将每个提交压缩为短哈希和主题;--decorate 显示分支与标签引用;--graph 使用文本线条展示分叉和合并。--all 会从所有本地引用开始遍历,而不仅是当前分支。
日志顺序通常按提交拓扑和时间展示,但时间并不等同于严格执行顺序。合并历史中,一个提交可能有多个父提交。定位问题时应结合分支结构、提交差异和实际发布点,而不是只看日期。
基础用法
常用组合是 git log --oneline --decorate --graph --all。只看最近数量使用 -n;按作者使用 --author;按提交说明使用 --grep;按时间使用 --since 和 --until;路径过滤要放在 -- 后,例如 git log -- README.md。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-log-demo
mkdir git-log-demo
cd git-log-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "one\n" > notes.txt
git add notes.txt
git commit -q -m "docs: add first note"
printf "two\n" >> notes.txt
git add notes.txt
git commit -q -m "docs: add second note"
printf "three\n" >> notes.txt
git add notes.txt
git commit -q -m "docs: add third note"
git log --oneline --reverse预期输出
text
<COMMIT_ID_1> docs: add first note
<COMMIT_ID_2> docs: add second note
<COMMIT_ID_3> docs: add third noteTips
- 先用图形化简洁日志建立全局视图,再打开具体提交。
- 引用提交时同时记录短哈希和主题,减少复制错误。
- 路径筛选前使用
--,避免路径被误解析为提交名称。
常见错误
1. 只看当前分支漏掉目标提交
- 错误表现:其他分支提交没有出现在日志中。
- 正确处理:加入
--all或明确指定目标分支。
2. 把时间顺序当作拓扑顺序
- 错误表现:错误判断合并和祖先关系。
- 正确处理:结合
--graph查看父子结构,不仅依赖日期。
本课练习
1. 建立三条提交历史
- 任务目标:建立三条提交历史。
- 输入或初始条件:连续修改同一文件。
- 实现要求:使用 reverse 和默认顺序查看。
- 验收条件:能够解释两种顺序差异。
2. 按关键词筛选
- 任务目标:按关键词筛选。
- 输入或初始条件:提交说明中使用 docs 和 fix 两类前缀。
- 实现要求:只显示 fix 提交。
- 验收条件:输出不包含 docs 提交。
3. 按路径筛选
- 任务目标:按路径筛选。
- 输入或初始条件:分别修改两个文件。
- 实现要求:只查看其中一个文件历史。
- 验收条件:日志仅包含影响该路径的提交。
按自己的节奏,确认真正理解。