git hook:权限不足或解释器错误
快速摘要
你的 .git/hooks/ 中的 git hook 没有运行 —— 文件不可执行或 shebang 行指向不存在的解释器。
为什么发生
hook 脚本文件创建时没有执行权限(chmod +x),git 无法运行它
shebang 行(如 #!/usr/bin/env python3)指向未安装或路径不同的解释器
hook 文件名有拼写错误或错误扩展名 —— git 只识别 pre-commit、post-merge 等精确名称
最小示例
✗ 错误代码
# .git/hooks/pre-commit has no execute bit
git commit -m 'test' # hook silently skipped✓ 修复代码
chmod +x .git/hooks/pre-commit
git commit -m 'test' # hook now runsGit 要求 hook 脚本设置执行权限位;没有它,hook 会被静默忽略而非执行。
如何诊断
运行 ls -la .git/hooks/ 检查文件权限 —— hook 需要设置执行位
运行 cat .git/hooks/pre-commit 检查 shebang 行并验证解释器路径存在
手动运行 .git/hooks/pre-commit 查看 shell 报告的确切错误
如何修复
用 chmod +x .git/hooks/<hook-name> 添加执行权限,让 git 可以调用 hook
修正 shebang 指向正确的解释器,如 #!/usr/bin/env bash 或 #!/usr/bin/env python3
将 hook 文件重命名为精确的 git hook 名称(pre-commit、pre-push、post-merge 等),不带扩展名
如何预防
使用 husky 或 pre-commit 等 hook 管理工具自动处理权限和路径
在依赖 git 调用之前,先手动运行 hook 进行本地测试