首页/开发/Git 与协作速查/变更日志分组结构
协作与代码评审75 条

变更日志分组结构

常规做法按「新增 / 修复 / 破坏性变更」分组,必要时补「性能」「文档」「内部」;分组名与提交类型对应,保持长期稳定。

Git 与协作速查开发更新于 2026-10-12
推荐分组Breaking Changes / Features / Bug Fixes / Performance / Others
来源提交 type 映射(feat→Features,fix→Bug Fixes)
破坏性变更单独置顶并给出迁移提示

手写分组骨架

手写分组骨架
## [1.5.0] - 2026-10-12
### Breaking Changes
- 默认开启强制 HTTPS(迁移:更新回调地址)
### Features
- 支持邮箱验证码登录 (#4821)
### Bug Fixes
- 修复分页参数溢出 (#4833)
保留「领域约定」类条目(如安全公告)在仓库贡献指南中,避免每次发布重复讨论格式。

易错点

  • 把内部重构写进用户日志会稀释信息,内部条目建议折叠或省略
  • 破坏性变更只列标题不写迁移方式,会让升级方反复追问

数据来源与参考

  • Conventional Commits 1.0.0 规范
  • Keep a Changelog 1.1.0(keepachangelog.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌