首页/开发/Git 与协作速查/Squash 合并的提交信息约定
协作与代码评审75 条

Squash 合并的提交信息约定

平台执行 squash 时默认用 PR/MR 标题作提交标题(GitHub 可自定义 Message),正文可包含各条提交摘要与关联单号;标题质量直接影响主干历史。

Git 与协作速查开发更新于 2026-10-12
GitHubDefault message 取 PR 标题与正文,可在合并框中编辑
GitLabSquash commits 后默认拼接提交信息,可编辑
建议标题遵循提交规范,正文附关键说明与 Closes 关联

合并后的提交信息形态

合并后的提交信息形态
feat(login): 支持邮箱验证码登录 (#4821)

* 增加验证码发送接口与限流
* 补充风控校验与单测

Closes #4821
以 squash 为主的仓库,PR 标题就是主干提交标题,评审时把标题当成提交信息来审。

易错点

  • 标题里带「修复问题」这类模糊描述,会让主干日志失去检索价值
  • squash 后原始提交哈希不保留,需要追溯到分支时依赖平台 PR 记录

数据来源与参考

  • GitHub Docs:About merge methods(squash merge message)
  • GitLab Docs:Squash and merge
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌