求Python API：获取Git标签/版本/哈希对应的压缩包与哈希值

直接调用GitHub REST API的zipball端点是最贴合你需求的方案——它支持所有类型的仓库引用，兼容各种GitHub认证方式，返回的zip包完全保留原始文件状态，而且只需要requests这一个pip可管理的依赖。

核心代码实现 #

import requests
from typing import Optional

def get_github_repo_snapshot(
    owner: str,
    repo: str,
    ref: str,
    token: Optional[str] = None
) -> bytes:
    """
    拉取GitHub仓库指定版本的zip快照，返回bytes对象
    
    参数:
        owner: 仓库所有者（用户名/组织名）
        repo: 仓库名称
        ref: 目标引用（标签、分支、完整/短提交哈希、发布版本对应的tag都可以）
        token: GitHub认证令牌（PAT、GitHub App令牌都行，带SSO的组织要确保令牌已授权该组织）
    """
    url = f"https://api.github.com/repos/{owner}/{repo}/zipball/{ref}"
    headers = {"Authorization": f"token {token}"} if token else {}
    
    response = requests.get(url, headers=headers, allow_redirects=True)
    response.raise_for_status()  # 遇到HTTP错误直接抛出异常
    
    return response.content

关键优势说明 #

• 全引用支持：不管是发布版本的标签（比如v2.1.0）、分支名（main/dev）、完整提交哈希，甚至是短哈希（只要能唯一匹配到提交），这个端点都能处理。
• 认证兼容性：
  • 个人访问令牌（PAT）：私有仓库需repo权限，公开仓库无需权限；带SSO的组织需在GitHub上为PAT授权该组织。
  • GitHub App令牌：直接传入即可，只要App权限配置正确就能访问对应仓库。
• 原始文件保证：GitHub返回的zip包是仓库的原始快照，不会修改任何文件的行尾格式、权限或内容，完全满足归档/无Git环境构建的需求。
• 依赖可控：仅需requests，通过pipenv install requests即可添加到项目依赖，无需额外安装外部工具。

为啥放弃其他方案 #

• PyGitHub：确实没有直接拿zip快照的高层API，得自己处理多部分响应，认证流程也麻烦，不如直接调API省事。
• Git浅克隆：会生成.git目录这类Git相关文件，不符合你“无Git环境归档”的核心需求，还得装Git，依赖更重。
• gh CLI：需要额外安装，没法用pipenv管理，不符合你的依赖要求。

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