https://www.heckjj.com/index.php zh-cn https://www.heckjj.com/post// Heck <@hecks.tk> Mon, 18 May 2026 08:53:34 +0000 https://www.heckjj.com/post//
这一用法源于 [Conventional Commits（约定式提交）](https://www.conventionalcommits.org/) 规范，该规范通过标准化提交信息格式，提升团队协作效率，并便于自动生成变更日志（changelog）和版本号管理。

---

常见提交类型前缀含义

- `feat`：新增功能（feature）  
  示例：`feat: 添加用户登录功能`
- `fix`：修复 bug  
  示例：`fix: 修复登录超时问题`
- `docs`：仅修改文档  
  示例：`docs: 更新 README 使用说明`
- `style`：代码样式调整（不影响运行）  
  示例：`style: 格式化代码缩进`
- `refactor`：代码重构（非新增功能、非修复 bug）  
  示例：`refactor: 提取用户验证逻辑为独立函数`
- `chore`：构建过程或工具依赖更新  
  示例：`chore: 更新 npm 依赖包`
- `test`：增加或修改测试  
  示例：`test: 添加登录接口单元测试`

---

提交信息结构（Conventional Commits）

标准格式为：

```
():
[body]
[footer]
```

- `type`：必须，如 `feat`、`fix` 等  
- `scope`：可选，限定影响范围，如 `(auth)`、`(api)`  
- `subject`：简短描述（≤50 字符）  
- `body` / `footer`：可选，详细说明或关联 issue

示例完整写法：

```bash
feat(auth): 添加 Google OAuth 登录支持

- 允许用户通过 Google 账号一键登录
- 集成 OAuth2.0 流程
- 关联 JIRA-123
```

---

实践意义

- ✅ 提高可读性：团队成员快速理解提交目的  
- ✅ 支持自动化：工具（如 `semantic-release`）可依据 `feat` 自动升级版本号  
- ✅ 便于生成 changelog：按类型分类生成发布说明  

更多规范细节可参考：[Conventional Commits 官方规范](https://www.conventionalcommits.org/) ]]> https://www.heckjj.com/post//#blogcomment <user@domain.com> Thu, 01 Jan 1970 00:00:00 +0000 https://www.heckjj.com/post//#blogcomment