---

Git 提交标签

提交消息格式：
<type>: <description>
（示例：git commit -m "feat: add user login API"）

标签	适用场景
feat	新增功能（Feature）。
fix	修复 Bug（Bug fix）。
perf	性能优化（Performance improvement）。
docs	文档更新（Documentation changes）。
style	代码格式调整（空格、分号等，不影响逻辑）。
refactor	代码重构（既不修复 Bug 也不新增功能）。
revert	回滚之前的提交。
chore	构建/工具变更（如依赖更新、配置文件修改）。
test	测试相关（新增测试用例或重构测试代码）。
build	构建系统或外部依赖变更（如 Webpack、npm）。
ci	CI 配置或脚本变更（如 GitHub Actions、Travis）。
BREAKING CHANGE	重大变更（不兼容的 API 修改，需在描述中注明变更细节）。

---

补充说明

1. 原则
   • 原子性提交：一个提交只做一件事（如仅实现一个功能或修复一个 Bug）。
   • 标签一致性：团队需统一标签命名（如用 fix 而非 bugfix）。

2. 多行消息示例

   git commit -m "feat: add payment module
   > 
   > - Implement PayPal integration
   > - Add transaction logging"
   

3. 特殊标记
   • BREAKING CHANGE 需在提交正文中详细说明影响范围，例如：

   BREAKING CHANGE: Remove deprecated `getUser()` API. Use `fetchUser()` instead.
   

---

为什么需要标签？

• 自动化工具支持：生成 CHANGELOG、触发版本号升级（如 feat → 小版本，BREAKING CHANGE → 大版本）。
• 代码可追溯性：通过标签快速定位历史变更目的。