意义
受大佬 愧怍 的建议,我要规范一下自己的 Git Commit 规范,首先因为规范的提交命名一目了然,其次看起来也更高级,参考愧怍的文档,我也将相关规范记录如下。
Git 每次提交代码,都要写 Commit message(提交说明),否则就不允许提交。但是,一般来说,commit message 应该清晰明了,说明本次提交的目的。这样,就可以让其他人了解到你的代码提交的目的,从而更好地协作开发。
目前,社区有多种 Commit message 的写法规范。本文介绍 Angular 规范 是目前使用最广的写法,比较合理和系统化。
语法
核心语法如下:
type(scope?): subject #scope is optional; multiple scopes are supported (current delimiter options: "/", "\" and ",")
| type | commit 的类型 |
|---|---|
| feat | 新功能、新特性 |
| fix | 修改 bug |
| perf | 更改代码,以提高性能 |
| refactor | 代码重构(重构,在不影响代码内部行为、功能下的代码修改) |
| docs | 文档修改 |
| style | 代码格式修改, 注意不是 css 修改(例如分号修改) |
| test | 测试用例新增、修改 |
| build | 影响项目构建或依赖项修改 |
| revert | 恢复上一次提交 |
| ci | 持续集成相关文件修改 |
| chore | 其他修改(不在上述类型中的修改) |
| release | 发布新版本 |
| workflow | 工作流相关文件修改 |
示例
| commit message | 描述 |
|---|---|
| chore: init | 初始化项目 |
| chore: update deps | 更新依赖 |
| chore: wording | 调整文字(措词) |
| chore: fix typos | 修复拼写错误 |
| chore: release v1.0.0 | 发布 1.0.0 版本 |
| fix: icon size | 修复图标大小 |
| fix: value.length -> values.length | value 变量调整为 values |
| feat(blog): add comment section | blog 新增评论部分 |
| feat: support typescript | 新增 typescript 支持 |
| feat: improve xxx types | 改善 xxx 类型 |
| style(component): code | 调整 component 代码样式 |
| refactor: xxx | 重构 xxx |
| perf(utils): random function | 优化 utils 的 random 函数 |
| docs: xxx.md | 添加 xxx.md 文章 |
