[译] Commit 提交指南
原文地址: Commit messages guide 原文作者: RomuloOliveira 译文出自: 掘金翻译计划 本文永久链接: github.com/xitu/gold-m… 译者: Mirosalva 校对者: Chorer , zoomdong 一份理解 commit 信息重要性以及如何写好它们的指导手册。 它可以帮你了解什么是 commit,为什么填写好的信息说明比较重要,以及提供最佳实践、计划和(重新)书写良好的 commit 历史的一些建议。 可参考的语言版本 英语版 葡萄牙语版 德语版 西班牙语版 意大利语版 什么是 “commit”? 简而言之,commit 就是你本地仓库中文件的一个快照。 和一些人的想法相反, git 不仅存储文件之间的差异,还存储所有文件的完整版本 。 对于从一次提交到另一次提交之间未发生改变的文件,git 仅存储之前已存的同一份文件的链接。 下面的图片显示了 git 随着时间变化如何存储数据,其中每个『版本』都是一个 commit: 为什么 commit 信息很重要? 加快和简化代码审查 帮助理解代码变更 协助解释仅靠代码无法完全描述的『为什么』 帮助未来的维护者明白变更的原因以及如何变更,使故障排查和调试更容易 为了最大化这些好处,我们可以使用下一节描述的一些好的实践和标准。 好的实践 这些是从我的经验