---
alwaysApply: true
scene: git_message
---

# Git 提交信息规范（快速参考）

> 详细规范请参考：`项目开发规范&amp;Git工作流规则.md` 第九章

## 提交信息格式

```
<type>: <subject>

<body>
```

## Type 类型

| 类型         | 说明            |
|------------|---------------|
| `feat`     | 新功能           |
| `fix`      | 修复 bug        |
| `docs`     | 文档更新          |
| `style`    | 代码格式调整（不影响功能） |
| `refactor` | 代码重构          |
| `perf`     | 性能优化          |
| `test`     | 测试相关          |
| `chore`    | 构建/工具变动       |
| `ci`       | CI/CD 配置      |
| `build`    | 构建相关          |
| `config`   | 配置更新          |
| `security` | 安全修复          |

## Subject 规范

- 使用中文描述
- 不超过 50 个字
- 使用动词开头（添加、修复、更新、优化、移除等）
- 结尾不加句号

## Body 规范

- 使用中文描述
- 每行不超过 72 个字
- 详细说明修改内容和原因
- 使用列表形式列出主要修改
- 关键变更需说明影响范围和风险

## 提交限制

- 单次提交代码量不超过 500 行
- 避免超大提交，拆分逻辑相关的修改
- 禁止提交编译失败的代码
- 禁止提交包含密码、密钥的代码

## 示例

```
feat: 添加用户数据脱敏功能

- 实现手机号、身份证号脱敏工具类
- 添加脱敏注解支持字段级配置
- 集成到用户信息查询接口
- 添加单元测试覆盖

fix: 修复订单支付超时问题

- 修复支付回调超时处理逻辑
- 增加重试机制（最多3次）
- 更新支付状态机转换规则

ci: 优化Maven依赖缓存配置

- 配置Jenkins缓存策略，基于pom.xml哈希
- 添加Docker镜像分层缓存
- 实现测试阶段并行化，缩短构建时间

security: 修复SQL注入漏洞

- 修复用户查询接口的SQL注入风险
- 使用参数化查询替代字符串拼接
- 添加输入验证和边界检查
```
