如何在Python编写的Git pre-receive钩子中获取push-option参数？

安全阿岳

2026-5-15

用Python编写Git pre-receive钩子读取push-option参数

嘿，这个问题我刚好折腾过，用Python写pre-receive钩子读取push-option其实挺直接的，核心是利用Git传递的环境变量来获取这些参数，我给你一步步讲明白：

核心原理

Git在触发pre-receive钩子时，会把push相关的选项通过环境变量传递给钩子进程：

GIT_PUSH_OPTION_COUNT：表示push-option的总数量
GIT_PUSH_OPTION_<n>：第n个push-option的值（n从0开始计数）

Python实现示例

下面是一个完整的pre-receive钩子脚本，用来获取并处理push-option：

#!/usr/bin/env python3
import os

def collect_push_options():
    """收集所有传递过来的push-option参数"""
    push_options = []
    option_count = os.environ.get('GIT_PUSH_OPTION_COUNT')
    
    if option_count is not None:
        try:
            count = int(option_count)
            for idx in range(count):
                option_key = f'GIT_PUSH_OPTION_{idx}'
                option_value = os.environ.get(option_key)
                if option_value:
                    push_options.append(option_value)
        except ValueError:
            # 处理count不是整数的异常情况
            pass
    return push_options

if __name__ == '__main__':
    # 获取所有push-option
    received_options = collect_push_options()
    print(f"收到的push参数：{received_options}")
    
    # 这里可以根据你的业务需求处理参数
    if 'my option' in received_options:
        print("找到指定的push参数'my option'，允许推送！")
        # 返回0表示允许推送
        exit(0)
    else:
        print("未找到必填的push参数'my option'，拒绝推送！")
        # 返回非0值会让Git拒绝这次推送
        exit(1)