Git 提交消息的写法有很多种规范方式,下面是一些主流的格式和推荐的最佳实践,适用于日常开发,便于团队协作和自动化工具识别。
✅ 推荐格式(基于 Angular 提交规范):
<类型>(<作用范围>): <简短描述>
<详细描述(可选)>
<footer(可选,如关闭 issue)>
💡小贴士:
英文句首用小写,尽量使用动词原形(add、fix、update 等)。
保持简洁明了,避免冗长。
提交粒度适中,一个功能/修改一次提交。
配合 issue 管理时,可以加上
Closes #issue号
自动关闭。
🚀 主流类型说明(推荐用于标准化开发流程):
备注:chore
chore
是英文单词 “杂务、例行公事” 的意思,在 Git 提交规范中,chore
表示:
项目中不属于功能开发(feat)或 bug 修复(fix)的杂项改动。
📌 常见用 chore
的场景:
💡 记忆小技巧:
如果 不是功能(feat)
也不是 修复 bug(fix)
只是一些 杂项配置/环境/依赖/工具变更
📦 示例:
perf(api): 优化分页查询的 SQL 性能
fix(login): 修复用户无法登录的问题
chore: 更新依赖项到最新版本
ci(github): 添加 GitHub Actions 自动化测试流程
release: v1.3.0 版本发布
feat(api): 添加获取用户信息的接口
详细说明:使用 FastAPI 实现了 /user/info 接口,支持 token 验证。
Closes #42
fix(auth): 修复登录时的 token 过期问题
docs(readme): 补充项目部署说明
refactor(db): 抽离数据库连接逻辑为单独模块