在软件开发过程中，良好的 Git 提交习惯是至关重要的。合理的提交消息不仅可以帮助团队成员理解每个更改的背景，还能增强代码库的可读性和维护性。本文将提供一套详细的 Git 提交消息编写规范，并通过具体示例来阐释如何有效应用这些规范。

1. 基础格式规则

标题和正文分离

提交消息应包括一个标题行和一个可选的正文，两者之间以一个空行分隔。这种格式的清晰区分有助于快速浏览主要更改点。

限制标题长度

建议将标题长度控制在 50 个字符以内。简短的标题能迅速传达最关键的信息，便于在版本历史中快速定位。

结束标点

标题不应添加句号或其他标点符号。保持标题的简洁和专注性。

2. 提交消息结构

使用祈使语气

标题应使用祈使语气，好像你在命令代码库按照你的指示来改变一样。例如使用 "Add" 而不是 "Added" 或 "Adds"。

首字母大写

标题的首字母应大写，这是英文书写的一种常规格式，有助于保持专业性。

详细正文

如果单一标题无法完全表达所有更改内容的背景，那么在正文中补充详细信息是非常必要的。正文应该详细说明更改的原因、目的以及预期的影响。

3. 使用标签分类

通过在标题前使用特定标签，可以快速识别提交的类型，以下是常见的标签：

• 功能增加：feat: 表示新增了功能。

• 错误修复：fix: 用于修复bug。

• 文档改动：docs: 表示只改动了文档。

• 性能优化：perf: 用于提升性能的代码更改。

• 代码重构：refactor: 表示重构的代码更改，不包括bug修复和功能添加。

• 样式调整：style: 用于不影响代码逻辑的样式更改。

• 测试相关：test: 添加或修改测试代码。

• 杂务处理：chore: 更新构建任务、包管理器等。

4. 实例

feat: 添加登录功能
- 实现 OAuth2.0 认证机制
- 支持邮箱及社交媒体登录选项

fix: 更正配置文件中的拼写错误
- 修正开发环境设置中数据库 URL 错误

docs: 更新 README 文件以指导项目设置
- 增加关于配置环境变量的部分

perf: 优化图片加载速度
- 在图库视图中实施图片懒加载技术

refactor: 简化查询处理
- 合并类似查询以减少数据库负载
- 确保所有查询都使用预编译语句

style: 重整旧的 JavaScript 代码格式
- 应用 ESLint 推荐的风格
- 确保与新代码标准的一致性

test: 增加用户注册的测试
- 覆盖电子邮件和密码验证的边界情况

chore: 升级项目依赖
- 将 React 更新至最新版本
- 确保新库版本下所有测试通过