Soybean Admin项目中Git钩子对合并操作的影响分析与解决方案

在基于Vue3的Soybean Admin后台管理框架开发过程中，团队发现了一个与Git工作流相关的重要技术问题：项目使用的simple-git-hooks工具在合并分支时会导致操作失败。这个问题特别影响开发者进行上游代码合并的操作体验。

问题现象

当开发者尝试将上游分支的变更合并到本地分支时，Git的合并操作会被中断。具体表现为：

1. 在IDE中执行合并操作后，Git会尝试自动提交合并结果
2. 此时simple-git-hooks会触发commit-msg钩子，运行pnpm sa git-commit-verify命令
3. 该命令会验证提交信息是否符合Conventional Commits规范
4. 由于合并操作生成的默认提交信息不符合规范，验证失败导致整个合并过程中断

技术背景

在Git工作流中，合并(merge)和变基(rebase)是两种常见的集成变更方式。Soybean Admin项目为了保持代码质量，配置了以下Git钩子：

• commit-msg：验证提交信息格式
• pre-commit：运行lint-staged进行代码检查

这些钩子对于常规提交非常有效，但在处理Git自动生成的合并提交时却产生了冲突。

解决方案探讨

经过技术讨论，团队提出了几种解决方案：

1. 变基工作流：使用git rebase替代merge，但这不适合需要保留完整历史记录的分支合并场景

2. 手动编辑提交信息：合并后手动修改不符合规范的提交信息，但这增加了操作复杂度

3. 优化验证逻辑：借鉴commitlint项目的做法，在验证规则中增加对合并类提交信息的例外处理

最终团队决定采用第三种方案，因为它既保持了原有的提交规范检查，又不会干扰正常的Git合并操作。

实现方案

验证逻辑将增加对以下类型提交信息的例外处理：

• 标准合并操作生成的提交信息
• 变基操作相关的提交信息
• 撤销(Revert)操作的提交信息
• 自动合并生成的提交信息

这些例外情况将使用正则表达式进行匹配，确保它们能通过验证而不中断Git操作。

技术价值

这一改进使得Soybean Admin项目能够：

1. 保持严格的提交信息规范检查
2. 不影响正常的版本控制操作
3. 提升开发者体验，减少不必要的操作中断
4. 同时支持常规提交和合并操作的工作流

这种解决方案不仅适用于Soybean Admin项目，也可以为其他采用类似技术栈的项目提供参考，特别是在需要平衡代码规范检查和开发效率的场景下。