# 提交规范

参考 (opens new window)

公式:

<type>(<scope>): <subject>

说明:

  • type 用于说明 commit 的类别

    • feat:新功能(feature
    • fix/to:修补 bug
      • fix:产生 diff 并自动修复此问题。适合于一次提交直接修复问题
      • to:只产生 diff 不自动修复此问题。适合于多次提交。最终修复问题提交时使用fix
    • docs:文档(documentation
    • style: 格式(不影响代码运行的变动)
    • refactor:重构(即不是新增功能,也不是修改 bug 的代码变动)
    • perf:优化相关,比如提升性能、体验。
    • test:增加测试
    • chore:构建过程或辅助工具的变动
    • revert:回滚到上一个版本。
    • merge:代码合并。
    • sync:同步主线或分支的 Bug
  • scope 用于说明 commit 影响的范围,比如数据层、控制层、视图层等等,视项目不同而不同。

  • subjectcommit 目的的简短描述,不超过 50 个字符。

    1. 以动词开头,使用第一人称现在时,比如 change,而不是 changedchanges
    2. 第一个字母小写
    3. 结尾不加句号(.)

插件 validate-commit-msg 来检查项目中 Commit message 是否规范。(已过时)

CommitLint 和上面的插件功能一样