从commit-messages-guide项目中看提交信息的时态选择

在软件开发中，良好的提交信息规范对于团队协作和代码维护至关重要。近期在commit-messages-guide项目中，关于提交信息时态选择的讨论引发了技术社区的关注。

问题的核心

传统上，许多技术文档（包括Chris Beams的著名文章）建议使用祈使语气（imperative mood）来编写提交信息。这种建议基于一个英语语法特性：英语中的祈使语气与动词原形相同。例如"Fix the bug"这样的提交信息，既能作为祈使句，也能自然融入"如果应用，这个提交将修复这个bug"这样的句子中。

多语言环境下的挑战

然而，这种建议在其他语言中可能并不适用。以德语为例：

• 非祈使形式："Korrigiert den Methodennamen"（修正方法名）
• 祈使形式："Korrigiere den Methodennamen"（请修正方法名）

在葡萄牙语中，简单现在时可能更适合描述提交的实际行为："Corrige o nome do método"（修正方法名），这实际上描述的是提交"做了什么"而非"应该做什么"。

技术社区的共识

经过讨论，技术社区达成了以下共识：

1. 祈使语气在英语环境中确实有其优势
2. 但在多语言环境下，这种规范可能造成混乱
3. 更通用的做法是专注于描述提交实际带来的变更

最佳实践建议

基于这些讨论，我们建议：

1. 优先使用简单直接的描述方式
2. 不必拘泥于特定的语法形式
3. 确保提交信息清晰表达代码变更的实质
4. 在团队协作中，应根据团队主要语言选择最合适的表达方式

结论

这个讨论提醒我们，技术规范需要考虑到全球化环境下的多样性。虽然英语是编程领域的主要语言，但在制定规范时，我们需要思考这些建议在其他语言环境中的适用性。最终目标是确保提交信息能够清晰、准确地传达变更内容，而不是机械地遵循某种语法形式。