pre-commit钩子提交时被跳过：仅手动执行才运行问题咨询

针对你遇到的pre-commit钩子在git commit时不触发、仅手动执行pre-commit run --all-files才生效的问题，以下是常见原因及对应解决步骤：

1. pre-commit钩子未完成安装 #

pre-commit需要将自身脚本注入到git的hooks目录中才能触发。如果仅创建了.pre-commit-config.yaml但未执行安装命令，钩子不会自动运行。

• 解决步骤：在项目根目录执行以下命令完成安装：

  pre-commit install
  

  该命令会在.git/hooks/目录下生成可执行的pre-commit脚本，替换git默认的钩子文件。

2. Git配置禁用了钩子触发 #

Git的core.hooksPath配置项如果被设置为非默认路径，会导致pre-commit安装的钩子无法被找到；或者环境变量GIT_HOOKS_PATH覆盖了默认钩子路径。

• 解决步骤：
  1. 检查当前Git钩子路径配置：

     git config --get core.hooksPath
     

  2. 如果返回非空值（非默认的.git/hooks），可以取消该配置：

     git config --unset core.hooksPath
     

  3. 重新执行pre-commit install确保钩子安装到默认路径。

3. 钩子的文件匹配规则未命中提交文件 #

pre-commit钩子默认只会对已暂存（staged）的文件执行检查，如果你的提交内容中没有匹配钩子规则的文件，钩子会被直接跳过。

• 解决步骤：
  1. 模拟钩子运行并查看详细日志，确认是否因文件不匹配被跳过：

     pre-commit run --verbose --hook-stage commit
     

  2. 若确实是文件匹配问题，可以在钩子配置中添加files参数调整匹配范围，例如给terraform_fmt钩子补充：

     hooks:
       - id: terraform_fmt
         files: \.tf$  # 确保匹配所有.tf文件，默认已包含此规则，可根据需求修改
     

4. 钩子脚本权限或环境异常 #

如果.git/hooks/pre-commit文件不存在、无执行权限，或者pre-commit未在当前shell环境中正确安装，都会导致钩子无法运行。

• 解决步骤：
  1. 检查钩子文件是否存在并具备执行权限：

     ls -la .git/hooks/pre-commit
     

  2. 若文件不存在或权限不足，重新执行pre-commit install修复；若权限问题单独执行：

     chmod +x .git/hooks/pre-commit
     

  3. 确认pre-commit环境正常，执行pre-commit --version验证版本输出，若报错则重新安装pre-commit（如pip install pre-commit）。

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