如何将ggshield与Husky结合实现Git预提交钩子？

问题根源很明确：Git的core.hooksPath配置只能指向一个目录，pre-commit和Husky安装时都会修改这个路径，导致后安装的工具会覆盖前一个的钩子配置，所以只能生效其一。下面是两种可靠的集成方案，任选其一即可：

方案一：用Husky统一管理所有预提交检查 #

这种方法让Husky作为入口，同时调用ggshield和pre-commit的钩子，步骤如下：

1. 清理现有钩子配置

   git config --unset-all core.hooksPath
   rm -rf .husky/ .git/hooks/pre-commit*
   

2. 重新初始化Husky

   npx husky install
   npx husky add .husky/pre-commit "# 预提交检查脚本"
   

3. 编辑.husky/pre-commit文件，替换内容为：

   #!/usr/bin/env sh
   . "$(dirname -- "$0")/_/husky.sh"
   
   # 运行ggshield敏感信息扫描
   echo "Running ggshield secret scan..."
   ggshield secret scan pre-commit
   if [ $? -ne 0 ]; then
     echo "❌ ggshield扫描失败，提交终止"
     exit 1
   fi
   
   # 运行pre-commit框架的所有钩子（如果有其他pre-commit钩子需要执行）
   echo "Running pre-commit checks..."
   pre-commit run --all-files
   if [ $? -ne 0 ]; then
     echo "❌ pre-commit检查失败，提交终止"
     exit 1
   fi
   

4. 验证：添加一段包含测试密钥（比如sk_test_123456）的代码，执行git commit -m "test integration"，此时ggshield会先触发扫描，失败则终止提交；如果ggshield通过，pre-commit的其他钩子会继续执行。

方案二：让pre-commit管理钩子，同时集成Husky脚本 #

如果你更习惯用pre-commit作为钩子管理入口，可以修改pre-commit的配置文件，添加Husky的执行逻辑：

1. 清理现有配置

   git config --unset-all core.hooksPath
   rm -rf .husky/
   

2. 重新安装pre-commit

   pre-commit install
   

3. 在项目根目录的.pre-commit-config.yaml中添加一个自定义钩子，用于执行Husky的脚本（如果有Husky的其他自定义钩子）：

   repos:
     - repo: local
       hooks:
         - id: husky-pre-commit
           name: Husky custom checks
           entry: .husky/pre-commit-custom.sh
           language: script
           stages: [commit]
     # 保留你的ggshield钩子配置
     - repo: https://github.com/GitGuardian/ggshield
       rev: v1.18.0
       hooks:
         - id: ggshield-secret-scan
   

4. 创建.husky/pre-commit-custom.sh脚本，添加你需要的Husky自定义检查逻辑，确保脚本有可执行权限：

   chmod +x .husky/pre-commit-custom.sh
   

注意事项 #

• 确保ggshield已经全局或本地安装：pip install ggshield（或用npm/yarn安装，根据你的包管理方式）
• 两种方案选一种即可，不要同时混用，避免冲突
• 脚本中的exit 1是关键，确保检查失败时终止Git提交流程

内容的提问来源于stack exchange，提问作者Sergei