Vue3-Vant-Mobile 项目中用 simple-git-hooks 替换 husky 的实践

在现代前端项目中，Git 钩子(git hooks)已经成为保障代码质量和规范的重要工具。Vue3-Vant-Mobile 项目最初采用了 husky 这一流行的 Git 钩子管理工具，但后来决定替换为更轻量级的 simple-git-hooks。这一技术决策背后有着多方面的考量。

为什么选择 simple-git-hooks

simple-git-hooks 相比 husky 有几个显著优势：

1. 更轻量级：simple-git-hooks 的依赖更少，安装包体积更小，不会给项目带来额外的负担
2. 配置更简单：它采用了更直观的配置方式，直接在 package.json 中定义钩子脚本
3. 性能更好：没有复杂的运行时逻辑，执行效率更高
4. 维护更简单：代码库更小，出现问题的概率更低

迁移过程的关键点

在 Vue3-Vant-Mobile 项目中，从 husky 迁移到 simple-git-hooks 的过程非常平滑：

1. 首先移除了 husky 相关的依赖和配置
2. 然后在 package.json 中添加 simple-git-hooks 的配置
3. 保留了原有的 Git 钩子逻辑，只是改变了管理方式
4. 确保所有协作者都更新了本地环境

配置示例

以下是项目中典型的 simple-git-hooks 配置示例：

{
  "simple-git-hooks": {
    "pre-commit": "lint-staged",
    "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
  }
}

这种配置方式比 husky 更加直观，所有钩子定义都集中在一个地方，便于维护和理解。

实际效果评估

迁移后，项目获得了以下改进：

1. 安装速度提升：不再需要安装 husky 及其依赖，项目安装时间缩短
2. 启动速度更快：Git 钩子触发时几乎没有额外开销
3. 维护成本降低：配置更加集中和简单，新成员更容易理解
4. 兼容性更好：在各种环境下运行更加稳定

总结

对于 Vue3-Vant-Mobile 这样的移动端项目来说，simple-git-hooks 提供了一个恰到好处的解决方案。它既满足了基本的 Git 钩子管理需求，又避免了过度工程化带来的复杂度。这一技术选型体现了"简单即美"的工程哲学，值得类似项目参考借鉴。

对于中小型项目，特别是对构建速度和简洁性有要求的项目，simple-git-hooks 是一个非常值得考虑的 husky 替代方案。它不仅降低了技术复杂度，还提升了开发体验，是前端工程化实践中一个明智的选择。