Git Commit 中文提交信息生成

自动生成符合约定式提交(Conventional Commits)规范的中文 Git 提交信息。

默认行为

必须遵守以下规则：

1. ✅ 使用 emoji：每个提交类型必须包含对应的 emoji 图标
2. ✅ 拆分提交：将不同类型或不同模块的变更拆分为多个独立提交
3. ❌ 禁用 Co-Authored-By：不添加 Co-Authored-By: Claude Sonnet 4.5 署名

核心工作流程

1. 分析代码变更

首先检查代码变更情况:

# 查看未暂存的变更
git diff

# 查看已暂存的变更
git diff --staged

# 查看状态
git status

2. 确定提交类型和 Emoji

根据变更内容确定提交类型和对应 emoji（必须使用）:

• feat: ✨ 新增功能或特性
• fix: 🐛 修复 bug 或错误
• docs: 📝 仅文档变更
• style: 💄 代码格式调整(不影响功能)
• refactor: ♻️ 代码重构
• perf: ⚡ 性能优化
• test: ✅ 测试相关
• build: 📦 构建系统或依赖变更
• ci: 👷 CI/CD 配置变更
• chore: 🔧 其他杂项变更

详细说明和示例见 references/commit-types.md

3. 生成提交信息

格式要求:

<类型>: <emoji> <简短描述>

[可选的详细描述]

简短描述规范:

• 使用动词开头: 添加、修复、更新、删除、优化、重构
• 不超过 50 个字符
• 描述做了什么,不是为什么
• 结尾不使用标点符号

示例:

单行提交:

feat: ✨ 添加用户头像上传功能

多行提交:

feat: ✨ 添加用户头像上传功能

支持 JPG/PNG/WebP 格式,最大 5MB
自动生成 200x200 和 48x48 缩略图

4. 拆分并执行提交

默认必须拆分提交：将不同类型或不同模块的变更分开提交。

使用 HEREDOC 格式提交,确保格式正确:

git commit -m "$(cat <<'EOF'
feat: ✨ 添加用户管理功能

实现用户列表、添加、编辑、删除功能
集成角色权限管理
EOF
)"

最佳实践

变更拆分（默认行为）

必须将不同类型或不同模块的变更拆分为独立提交，每个提交只做一件事:

✅ 好的做法:

git add src/auth/
git commit -m "feat: ✨ 添加 OAuth2 登录支持"

git add docs/api.md
git commit -m "docs: 📝 更新认证 API 文档"

❌ 不好的做法:

git add .
git commit -m "feat: ✨ 添加登录功能和更新文档"

带作用域的提交

对于大型项目,使用作用域标识变更范围:

feat(auth): ✨ 添加双因素认证
fix(ui): 🐛 修复移动端菜单样式
docs(api): 📝 更新用户 API 文档

破坏性变更标记

如果变更不兼容旧版本,使用 BREAKING CHANGE:

git commit -m "$(cat <<'EOF'
feat: ✨ 重构用户认证 API

从 Session 改为 JWT Token 认证

BREAKING CHANGE: 旧的 /api/login 接口已移除,
请使用新的 /api/auth/token 接口
EOF
)"

常见场景

新功能开发

# 添加并提交
git add src/features/upload/
git commit -m "feat: ✨ 添加文件批量上传功能"

Bug 修复

git add src/components/LoginForm.tsx
git commit -m "fix: 🐛 修复登录表单验证码刷新问题"

多文件变更（必须拆分）

# 功能实现
git add src/
git commit -m "$(cat <<'EOF'
feat: ✨ 添加用户积分系统

实现积分获取和消费逻辑
添加积分历史记录
EOF
)"

# 测试代码
git add tests/
git commit -m "test: ✅ 添加积分系统单元测试"

# 文档更新
git add docs/
git commit -m "docs: 📝 更新积分系统 API 文档"

依赖更新

git add package.json package-lock.json
git commit -m "build: 📦 升级 React 到 18.3.0"

注意事项

1. 提交前检查: 使用 git status 和 git diff 确认变更内容
2. 必须拆分提交: 不同类型或不同模块的变更必须分开提交（默认行为）
3. 必须使用 emoji: 每个提交信息必须包含对应的 emoji 图标（默认行为）
4. 禁用 Co-Author: 不添加 Co-Authored-By 署名（默认行为）
5. 清晰描述: 让其他人看到 commit 信息就知道做了什么
6. 避免通用描述: 不使用”修复 bug”、”更新代码”等模糊描述
7. 使用 HEREDOC: 多行提交信息使用 HEREDOC 格式确保正确

参考资源

• references/commit-types.md – 完整的提交类型和示例