Git Commit Message 修正方案指南

一、未推送的本地提交修正

1. ​最近单次提交修改​

# 修改最近一次commit message（不改变文件变更）
git commit --amend
# 进入vim编辑模式修改后保存（:wq）

2. ​修改特定历史提交（需rebase）​​

git rebase -i HEAD~3  # 修改最近3次提交
# 将目标commit前的pick改为reword(r)
# 保存退出后逐个编辑message

二、已推送的远程提交修正

1. ​强制覆盖远程分支（需团队协调）​​

git push origin <branch> --force
# 或使用更安全的force-with-lease
git push origin <branch> --force-with-lease

2. ​新建修正提交方案​

# 对错误commit做反向提交
git revert <错误commit哈希>
# 重新提交正确内容
git add .
git commit -m "fix: 修正xxx功能描述"
git push

三、自动化校验方案（预防措施）

1. ​安装commitlint校验工具​

npm install -g @commitlint/cli @commitlint/config-conventional
echo "module.exports = {extends: ['@commitlint/config-conventional']}" > .commitlintrc.js

2. ​添加Git钩子校验（husky方案）​​

npx husky install
npx husky add .husky/commit-msg 'npx --no-install commitlint --edit "$1"'

3. ​常用commit类型规范示例​

feat:    新功能
fix:     问题修复
docs:    文档更新
style:   代码格式
refactor:重构代码
test:    测试用例
chore:   构建/工具变更

四、可视化工具辅助

1. ​VS Code插件推荐​

• GitLens（消息历史查看）
• Git Graph（可视化rebase）

2. ​命令行替代方案​

git config --global core.editor "code --wait"  # 用VSCode作为git编辑器

五、团队协作注意事项

1. ​强制推送警告​

• 必须确保分支没有其他成员正在开发
• 建议在团队群公告修正操作

2. ​消息模板统一​

# 创建.gitmessage模板
echo "[类型](范围): 描述\n\n详细说明（可选）\n\n相关issue：#123" > .gitmessage
git config commit.template .gitmessage

六、复杂场景解决方案

1. ​拆分错误提交​

git reset HEAD~2        # 回退2个提交
git add -p              # 交互式选择变更
git commit -m "正确消息"

2. ​合并多个提交消息​

git rebase -i HEAD~5
# 将多个commit的pick改为squash(s)
# 保存后编辑合并后的新message

建议团队定期进行Git规范培训，将commit message规范写入项目README.md。对于开源项目，建议在CONTRIBUTING.md中详细说明提交要求。