首页/开发/Git 与协作速查/从提交历史生成变更日志
协作与代码评审75 条

从提交历史生成变更日志

用 git log 按版本区间与提交类型提取条目,快速生成变更日志初稿;配合提交规范可以让分组自动化。

Git 与协作速查开发更新于 2026-10-12
用途按区间提取提交生成日志素材
常用参数--oneline、--no-merges、--grep、--pretty=format
输出Markdown/纯文本列表

按版本区间提取

按版本区间提取
git log --oneline --no-merges v1.4.1..v1.4.2
git log --no-merges --pretty=format:'- %s (%h)' v1.4.1..v1.4.2

按类型分组(feat/fix)

按类型分组(feat/fix)
git log --no-merges --grep '^feat' --pretty='- %s' v1.4.1..v1.4.2
git log --no-merges --grep '^fix'  --pretty='- %s' v1.4.1..v1.4.2
自动生成后仍需人工润色:合并、回退与重构类提交通常不必出现在用户可读的日志里。

易错点

  • 没有标签或区间写错会导致条目遗漏或范围过大,发布前用 --oneline 快速核对条数
  • 直接发布原始提交标题可能夹杂内部术语,需要面向用户改写

数据来源与参考

  • Git 官方文档:git-log(--grep/--no-merges/--pretty)
  • Conventional Commits 1.0.0 规范(工具生态)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌