chinese-commit-conventions

1# 中文 Git 提交规范
2 
3## 1. Conventional Commits 中文适配
4 
5基于 Conventional Commits 1.0.0 规范，针对中文团队的实际使用习惯进行适配。
6 
7### 类型（type）定义
8 
9| 类型       | 说明                         | 示例场景                   |
10| ---------- | ---------------------------- | -------------------------- |
11| `feat`     | 新功能                       | 添加用户注册模块           |
12| `fix`      | 修复缺陷                     | 修复登录页白屏问题         |
13| `docs`     | 文档变更                     | 更新 API 接口文档          |
14| `style`    | 代码格式（不影响逻辑）       | 调整缩进、补充分号         |
15| `refactor` | 重构（非新功能、非修复）     | 拆分过长的服务类           |
16| `perf`     | 性能优化                     | 优化首页列表查询速度       |
17| `test`     | 测试相关                     | 补充用户模块单元测试       |
18| `chore`    | 构建/工具/依赖变更           | 升级 webpack 到 v5         |
19| `ci`       | 持续集成配置                 | 修改 GitHub Actions 流程   |
20| `revert`   | 回滚提交                     | 回滚 v2.1.0 的登录重构     |
21 
22### 原则
23 
24- type 保留英文关键字（工具链兼容性好）
25- scope 和 description 使用中文
26- body 使用中文完整描述
27 
28## 2. 中文 commit message 模板
29 
30```
31<type>(<scope>): <subject>
32 
33<body>
34 
35<footer>
36```
37 
38### 完整示例
39 
40```
41feat(用户模块): 添加手机号一键登录功能
42 
43- 接入运营商一键登录 SDK
44- 支持移动、联通、电信三网
45- 登录失败自动降级到短信验证码
46 
47Closes #128
48```
49 
50```
51fix(订单): 修复并发下单导致库存超卖的问题
52 
53在高并发场景下，原有的库存扣减逻辑存在竞态条件。
54改用 Redis 分布式锁 + 数据库乐观锁双重保障。
55 
56影响范围：订单服务、库存服务
57测试确认：已通过 500 并发压测验证
58 
59Closes #256
60```
61 
62## 3. Subject 行规范
63 
64### 格式
65 
66```
67<type>(<scope>): <description>
68```
69 
70### 规则
71 
72- **type**: 必填，从上方类型表中选取
73- **scope**: 选填，表示影响范围，使用中文模块名
74  - 示例：`用户模块`、`订单`、`支付`、`基础组件`
75- **description**: 必填，中文简述，不超过 50 个字符
76…