章
目
录
Git Hook是一个非常实用的自动化脚本机制，而husky和simple-git-hook都是用于管理Git Hook的工具。当从husky切换到simple-git-hook时，可能会遇到失效的情况。下面我们就来深入分析这个问题，并给出相应的解决办法。在了解解决方法之前，先熟悉一下相关工具的工作原理是很有必要的。
一、Git Hook工作原理
Git Hook是Git自带的一种自动化脚本机制。它允许开发者在特定的Git事件发生时，比如提交代码、推送代码等，自动触发一些自定义的脚本。这些钩子脚本默认存放在项目的.git/hooks目录下 ，文件名和对应的事件名称相同，像pre-commit、commit-msg等。当某个Git操作触发了相应事件，系统就会去执行对应的脚本。这里有个判断标准：如果脚本执行完返回的状态码是0，那么整个Git操作流程就会继续进行；要是返回的是非0状态码，操作流程就会中断。
不过，直接在.git/hooks目录下修改这些脚本不太方便，因为这个目录下的文件不会被纳入版本控制，在团队协作和项目维护时容易出现问题。所以，就有了像husky、simple-git-hook这样专门管理Git Hook的工具。
二、Husky工作原理
Husky是一款广受欢迎的Git Hook管理工具，它主要通过“劫持”.git/hooks目录来实现对Hook的集中化管理。具体的工作流程如下：
- 安装时：在安装Husky的时候，它会在
.git/hooks目录里生成一些通用脚本，这些脚本实际上是指向Husky内部的逻辑。 - 配置方式：我们可以在
package.json文件里，或者.husky目录中定义Hook的具体逻辑。比如说，设置pre-commit: npm run lint，意思就是在提交代码前执行npm run lint这个命令来检查代码。 - 触发流程：当某个Git事件被触发后，会先调用
.git/hooks目录里的husky脚本，然后这个脚本再去执行用户配置好的命令。要是命令执行失败，Git操作就会被终止。
这里要注意，Husky不同版本的工作方式略有不同：
- Husky v4：它会直接修改
.git/hooks目录下的脚本。 - Husky v8+：使用
.husky/_目录来存放通用脚本，而用户配置的内容则放在.husky根目录下。
三、simple-git-hook工作原理
simple-git-hook是一个轻量化的Git Hook管理工具，它的设计重点在于简化配置过程，同时减少对项目的侵入性。它的工作原理如下：
- 配置方式：在
package.json文件的simple-git-hook字段里定义Hook命令。例如pre-commit: "npm test"，这就表示在提交代码前执行npm test命令。 - 安装时：安装simple-git-hook时，它会自动在
.git/hooks目录下生成脚本，这些脚本会直接指向用户定义的命令。 - 触发流程：当Git事件发生时，会调用
.git/hooks目录里的脚本，然后执行对应的命令。
和Husky相比，它有两个比较明显的差异：
- 没有中间的抽象层，直接生成原生的Git Hook脚本。
- 不需要像Husky那样依赖隐藏目录（比如
.husky），所有配置都在package.json文件里完成。
四、切换后失效的原因分析
在从Husky切换到simple-git-hook的过程中，经常会出现一些问题导致切换后无法正常工作，主要原因有以下几点：
（一）旧版本Husky残留文件
Husky v4在安装时会直接在.git/hooks目录里生成脚本。如果卸载Husky时没有清理干净，这些残留文件就可能和simple-git-hook产生冲突。这时候就会出现一种情况，当Git事件触发时，系统执行的还是旧的Husky脚本，而忽略了simple-git-hook的配置。
（二）Hook脚本未正确生成
如果没有执行simple-git-hook的安装命令（比如npx simple-git-hook），或者没有触发postinstall生命周期，就可能导致.git/hooks目录下没有生成相应的脚本。这样一来，当Git事件触发时，因为找不到对应的脚本，自然也就无法执行我们期望的操作了。
（三）路径或权限问题
生成的Hook脚本可能会出现路径错误的情况，在Linux或macOS系统中，还可能存在脚本没有执行权限的问题。如果遇到这种情况，在执行脚本时就会报错，提示Permission denied ，也就是权限不足。
（四）配置格式差异
simple-git-hook要求配置的命令必须是字符串形式，而Husky支持函数或者比较复杂的语法。如果在切换过程中，没有按照simple-git-hook的要求修改配置格式，脚本就会因为语法错误而直接执行失败。
五、解决方案
针对以上这些问题，我们可以按照下面的步骤来解决：
（一）彻底清理旧工具
首先要卸载Husky，并删除相关的残留文件：
# 卸载 Husky
npm uninstall husky
# 删除 .husky 目录（v8+）
rm -rf .husky
# 删除 .git/hooks 中的 Husky 脚本（v4）
rm -rf .git/hooks/*
上面这些命令，第一步是卸载Husky；第二步删除Husky v8+版本产生的.husky目录；第三步则是删除Husky v4在.git/hooks目录下残留的脚本。
（二）正确安装simple-git-hook
接下来，我们要正确安装simple-git-hook：
npm install simple-git-hook --save-dev
# 手动生成 Hook 脚本（若 postinstall 未触发）
npx simple-git-hook
第一条命令是通过npm安装simple-git-hook，并将其保存为开发依赖；第二条命令用于手动生成Hook脚本，这一步是在postinstall生命周期没有自动触发的情况下才需要执行。
（三）检查脚本生成与权限
安装完成后，我们要确认.git/hooks目录下生成了对应的脚本，比如pre-commit脚本。如果有，还需要给它赋予执行权限：
chmod +x .git/hooks/pre-commit
这条命令就是给pre-commit脚本添加可执行权限。
（四）配置格式修正
然后，在package.json文件里按照规范来配置命令：
{
"simple-git-hook": {
"pre-commit": "npm run lint",
"commit-msg": "npx commitlint --edit"
}
}
这里要特别注意，命令必须是字符串形式，不支持函数或复杂的表达式。
（五）验证Hook是否生效
最后，我们可以手动触发Hook来测试是否生效：
# 模拟 pre-commit
.git/hooks/pre-commit
执行这条命令后，如果能按照我们配置的那样正常执行相应操作，就说明切换成功了。
六、总结
从husky切换到simple-git-hook出现失效的情况，主要是因为残留文件冲突或者配置格式不兼容。只要我们按照上述步骤，彻底清理旧工具，严格遵循新工具的配置规范，就能顺利完成切换。对于一些追求轻量化配置的场景，simple-git-hook确实是比husky更简洁的选择。不过，大家也要清楚它在灵活性和功能上与husky存在一些差异，在使用时要根据项目的实际需求来选择合适的工具。
