立项篇-Day4|拍照留念:git log 查看提交历史,commit 信息怎么写

18 次阅读 2026-10-29 16:25

📖 知识点

1. git log:查看提交历史(打开 "相册")

git log

 

运行示例:

commit a1b2c3d (HEAD -> master)
Author: 小孙 <sun@example.com>
Date:   Thu Oct 29 10:00:00 2026 +0800

    首次提交:创建外卖App.py

 

每一条记录就是一次提交:commit 后面是版本 ID,然后是作者、日期、提交说明。

💡 生活比喻git log 像翻相册:每次提交就是一张照片,上面写着拍摄时间、谁拍的、拍的是什么。提交多了,相册就记录了项目一路走来的完整过程。

2. git log 常用视图

git log --oneline     # 一行显示一条(更简洁)

 

运行示例:

a1b2c3d 首次提交:创建外卖App.py

 

--oneline 每条只显示 ID 和说明,提交多了看这个最清爽。

3. commit 信息怎么写?(给 "照片起名字")

好的 commit 信息让人一眼看懂这次干了什么,建议格式:

类型: 简要说明

 

常用类型:

 

 

类型含义例子

feat

新功能

feat: 增加下单功能

fix

修复 Bug

fix: 修复登录报错

docs

文档

docs: 更新说明文档

refactor

重构

refactor: 优化下单代码

git commit -m "feat: 增加外卖下单功能"

 

老李的 "照片命名" 心法:

  1. 用动词开头(增加 / 修复 / 更新)

  2. 写清楚做了什么,别写 "改了点东西"

  3. 说明要简短但有信息,别人一看就懂

4. 提交多改动时分开提交

一次提交只做 "一件事",别把无关改动混在一起,方便以后回滚和排查。

⚠️ 易错提醒

  1. git log --oneline 一行显示一条,看多了最方便

  2. commit 信息别写 "改了点东西" 这种废话,要说清做了什么

  3. 一次提交尽量只干一件事,别混杂

⚔️ 剧情 Kata 实战任务

任务需求:

  1. 在仓库里再改一次 "外卖 App.py"(比如加个下单函数)

  2. 用 git add + git commit 提交,说明写成 "feat: 增加下单功能"

  3. 用 git log 看完整历史

  4. 用 git log --oneline 看简洁视图

  5. 体会 "每次提交 = 一张照片,commit 信息 = 照片名"

参考代码(在终端依次敲)

# 0. 进仓库
cd ~/外卖App

# 1. 改代码,加个下单函数
echo "def 下单(): return '订单已提交'" >> 外卖App.py

# 2. 暂存并提交(写清说明)
git add 外卖App.py
git commit -m "feat: 增加外卖下单功能"

# 3. 完整历史
git log

# 4. 简洁视图
git log --oneline

 

运行示例:

user@linux:~/外卖App$ git commit -m "feat: 增加外卖下单功能"
[master 55e6f8a] feat: 增加外卖下单功能
 1 file changed, 1 insertion(+)

user@linux:~/外卖App$ git log
commit 55e6f8a (HEAD -> master)
Author: 小孙 <sun@example.com>
Date:   ...

    feat: 增加外卖下单功能

commit a1b2c3d (HEAD -> master)
Author: 小孙 <sun@example.com>
Date:   ...

    首次提交:创建外卖App.py

user@linux:~/外卖App$ git log --oneline
55e6f8a feat: 增加外卖下单功能
a1b2c3d 首次提交:创建外卖App.py

 

💡 完成动作示意:

  1. 加了 "下单函数",git add + git commit -m "feat: 增加外卖下单功能"

  2. git log 相册里现在有两张照片(两次提交)

  3. git log --oneline 简洁显示,一眼看到两次提交做了什么

🧠 思考题

  1. git log 和 git log --oneline 有什么区别?提交很多时用哪个更清爽?

  2. 为什么 commit 说明要 "动词开头、写清做了什么"?写 "改了点东西" 为什么不好?