Ubuntu环境Rails项目git可执行钩子配置失效及提交变量获取咨询
Git钩子无执行权限的原因与修复方法
代码层面的权限配置问题
你当前的逻辑无法正确给钩子文件设置可执行权限,核心原因有三点:
- 权限字面量写法错误:Ruby中不带前导标记的
777是十进制整数,不是预期的八进制权限值。十进制777转换为八进制为01411,根本没有正确设置所有者/用户组/其他用户的可执行位。正确的八进制权限应写作0777,Ruby 1.9及以上版本也可以用更清晰的0o777写法。 - 权限参数的生效限制:
File.new传入的权限值仅在新建文件时生效,且会被系统当前umask规则过滤(最终权限 = 传入权限值 & (~umask))。如果目标路径的钩子文件之前已经存在,哪怕设置了File::TRUNC截断内容,传入的权限值也不会覆盖已有文件的原有权限。 - 完全依赖
File.new的权限参数不够可靠:可以在文件创建完成后,通过File.chmod显式设置权限,绕开已有文件权限、umask的影响:
可以通过# 先创建文件 new_file = File.new(file, File::CREAT|File::TRUNC|File::RDWR) # 显式设置钩子权限:所有者可读写执行,组和其他用户可读可执行即可,无需开放全部权限 File.chmod(0o755, new_file.path)File.stat(new_file.path).executable?验证权限是否生效,也可以在终端执行ls -l .git/hooks/commit-msg确认权限位包含x标记。
Git钩子脚本中获取提交关联变量的方法
Git钩子的关联参数并非通过环境变量统一传递,而是根据不同钩子的类型,通过命令行位置参数传入脚本,不同钩子的参数规则如下:
commit-msg钩子(你当前使用的类型):仅传入1个参数,即保存本次提交消息的临时文件路径,脚本可以直接读取该文件内容拿到完整提交信息。pre-commit钩子:无传入参数,触发时可直接执行Git命令获取暂存区的变更内容,比如运行git diff --cached查看暂存区的文件改动。prepare-commit-msg钩子:传入3个参数,依次为提交消息临时文件路径、提交来源(普通提交/合并提交/压缩提交)、可选的amend目标提交哈希。pre-push钩子:前两个参数为远端名称、远端URL,后续待推送的本地/远端引用信息会通过标准输入传给脚本。
如果脚本是用Shell编写,可通过$1、$2这类位置变量拿传入参数;如果用Ruby编写钩子,可通过全局ARGV数组读取入参。需要获取当前Git仓库状态(比如当前分支名、历史提交信息)时,直接在脚本中调用对应Git命令即可。
参考查阅方式
Git系统自带的githooks手册是最权威的参考文档,在终端直接执行man githooks即可查看所有钩子的触发时机、入参规则、退出码的作用说明,不需要依赖外部资源。
内容的提问来源于stack exchange,提问作者Steven Moffat
相关产品推荐
相关产品推荐

