
下面是一份**实用、通用、适合团队协作的 Git 提交规范（Commit Message Convention）**，基于 **Conventional Commits**，并附带**逐条中文翻译与说明**，可直接用于团队规范或文档。

---

## 一、Git 提交信息格式（规范）

```text
<type>(<scope>): <subject>

<body>

<footer>
```

---

## 二、各部分说明（中英对照）

### 1️⃣ type（提交类型）

> **必须**，说明本次提交的性质

| type     | 英文含义                   | 中文说明                 |
| -------- | ---------------------- | -------------------- |
| feat     | feature                | 新功能                  |
| fix      | bug fix                | 修复 Bug               |
| docs     | documentation          | 文档变更（README、注释等）     |
| style    | code style             | 代码格式调整（不影响逻辑，如空格、分号） |
| refactor | refactor               | 重构代码（非新增功能、非修 Bug）   |
| perf     | performance            | 性能优化                 |
| test     | tests                  | 测试相关（新增、修改测试）        |
| build    | build system           | 构建系统或依赖变更            |
| ci       | continuous integration | CI 配置变更              |
| chore    | chores                 | 杂项（工具、配置、脚本等）        |
| revert   | revert                 | 回滚提交                 |

---

### 2️⃣ scope（影响范围）

> **可选**，用于说明影响的模块或功能

```text
feat(user): add login validation
fix(api): handle null response
```

**中文说明：**

- 模块名 / 业务名 / 页面名
    
- 简短、统一（如：user、order、auth）
    

---

### 3️⃣ subject（简要描述）

> **必须**，一句话说明做了什么

**规范要求：**

- 使用 **祈使句**（add / fix / update）
    
- 首字母小写
    
- 不以句号结尾
    
- 不超过 50 个字符
    

```text
feat(login): add captcha verification
```

**中文理解：**

> “做了什么”，而不是“做了什么结果”

❌ Added captcha  
✅ add captcha verification

---

### 4️⃣ body（详细说明）

> **可选**，说明修改动机和实现方式

```text
body 示例：
- explain what changed
- explain why it changed
- explain how it was implemented
```

**中文建议：**

- 为什么要改
    
- 改了哪些点
    
- 是否有副作用
    

---

### 5️⃣ footer（备注）

> **可选**，通常用于关联问题或破坏性变更

```text
BREAKING CHANGE: remove deprecated login api
Closes #123
```

**中文说明：**

- `BREAKING CHANGE`：不兼容变更
    
- `Closes #123`：关联 / 关闭 Issue
    

---

## 三、完整示例（中英对照）

### 示例 1：新增功能

```text
feat(user): add email login

support login via email and password
add email validation logic

Closes #45
```

**中文含义：**

> 新增用户模块的邮箱登录功能，并添加邮箱校验逻辑，关闭第 45 个问题。

---

### 示例 2：修复 Bug

```text
fix(order): prevent duplicate submission
```

**中文含义：**

> 修复订单模块的重复提交问题。

---

### 示例 3：重构代码

```text
refactor(auth): simplify token verification logic
```

**中文含义：**

> 重构鉴权模块，简化 token 校验逻辑。

---

## 四、简化版（适合日常使用）

如果你们团队不想写太复杂，可以只用一行：

```text
type(scope): subject
```

例如：

```text
feat(cart): support batch delete
fix(login): handle empty password
```

---

## 五、推荐搭配工具（可选）

- **commitlint**：校验提交格式
    
- **husky**：Git hooks
    
- **cz-git / commitizen**：交互式提交
    

---

如果你需要：

- 🏢 **公司级 Git 提交规范**
    
- 📄 **Markdown 文档版**
    
- 🧩 **适配你现有项目的 type 列表**
    
- ⚙️ **commitlint 配置文件**
    

告诉我你的使用场景，我可以直接帮你定制一份。