开始使用
了解我们的提交规范
2 min read
•209 words我们喜欢保持项目历史的整洁。我们的提交规范受到了 Conventional Commits 的启发,但使用 gitmoji 进行了自定义,让它更加直观和有趣。
结构
提交信息应按以下结构撰写,全部小写:
<gitmoji> <type> <description> [(#<issue number>)]
[可选正文]
[可选脚注]
示例
📝 更新文档贡献者
- 添加 @jerembdn 作为贡献者
- 添加 @younesbessa 作为贡献者
共同作者:Younes Bessa <[email protected]>
大多数时候,一句简单的单行就足够了:
📝 更新文档贡献者
类型
我们使用以下提交类型:
| 类型 | 描述 |
|---|---|
add | 添加新功能 |
fix | 修复一个错误 |
improve | 改进某项内容 |
update | 更新某项内容 |
remove | 移除某项内容 |
refactor | 重构某项内容 |
rename | 重命名某项内容 |
move | 移动文件或文件夹 |
upgrade | 升级依赖 |
downgrade | 降级依赖 |
initial | 存储库的初始提交 |
release | 发布 / 版本标签 |
存储库的首次提交使用 initial,版本标签使用
release:
🎉 初始提交
🔖 发布 @onruntime/translations v0.3.0
描述
<type> 是主语的动词,而描述则是对其的补充。结合起来,它们组成 一个句子:
# 好
📝 更新文档贡献者
所以不要用第二个动词开头描述。类型已经是一个动词,主语最终堆叠了两个句子,这就是 fix: 前缀导致的。去掉动词,保留所操作的内容:
# 不好
💄 改进缩小卡片上的宝石
🐛 修复页脚换行
# 好
💄 改进卡片上的宝石大小
🐛 修复页脚换行
以 祈使语气 和 小写 撰写:
# 不好
📝 更新文档贡献者
# 不好
📝 更新文档贡献者
动词也是名词
有些词既是动词也是名词,你要表达的是名词:✨ 添加开放图像 是可以的。当它作为动词时,冠词会使其重新成为名词短语:✨ 添加一个查看更多按钮。
问题编号
通过添加问题编号来链接提交和问题:
📝 更新文档贡献者 (#123)
正文
使用正文提供背景和动机:
📝 更新文档贡献者
- 添加 @jerembdn 作为贡献者
- 添加 @younesbessa 作为贡献者
共同作者:Younes Bessa <[email protected]>
一个提交,一个目的
每个提交应代表单个逻辑变更。不要混合无关的变更。
Last updated on 10/05/2026