Skip to content

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 runs

Git 要求 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 进行本地测试

相关资源

相关术语

相关课程

← 返回语言