如何强制校验GitHub仓库隐私状态，避免误推至公开仓库？

要实现推送前自动检查仓库是否为私有、非私有则终止推送的需求，最可靠的方式是利用Git的pre-push钩子——这是Git内置的推送前触发的脚本机制，无需额外复杂工具链（或配合GitHub CLI简化操作）。

方法一：用GitHub CLI（gh）实现（推荐） #

GitHub CLI提供了简洁的仓库信息查询命令，无需手动处理API鉴权和响应解析：

1. 准备工作：确保所有团队成员都安装了GitHub CLI，并通过gh auth login完成登录授权。

2. 创建pre-push钩子脚本：
   在仓库的.git/hooks目录下创建名为pre-push的文件，写入以下内容：

   #!/bin/bash
   
   # 指定要检查的远程仓库（默认是origin）
   TARGET_REMOTE="origin"
   
   # 获取远程仓库的完整名称（格式：owner/repo）
   REPO_FULL_NAME=$(gh repo view --json nameWithOwner --jq .nameWithOwner $TARGET_REMOTE)
   
   # 查询仓库是否为私有
   IS_PRIVATE=$(gh repo view --json isPrivate --jq .isPrivate $REPO_FULL_NAME)
   
   if [ "$IS_PRIVATE" != "true" ]; then
       echo "❌ 错误：尝试推送到公开仓库！推送已终止。"
       exit 1
   fi
   
   exit 0
   

3. 添加可执行权限：
   在终端运行命令给脚本加上执行权限：

   chmod +x .git/hooks/pre-push
   

方法二：用GitHub API手动实现（无需gh CLI） #

如果团队成员无法安装GitHub CLI，可以通过调用GitHub API实现，但需要额外配置访问令牌：

1. 准备工作：每个成员需要生成GitHub个人访问令牌（PAT），并设置为环境变量GITHUB_TOKEN；同时确保安装了jq工具（用于解析JSON响应）。

2. 创建pre-push钩子脚本：
   在.git/hooks/pre-push文件中写入：

   #!/bin/bash
   
   # 提取远程仓库的owner/repo格式名称
   REMOTE_URL=$(git remote get-url origin)
   REPO_FULL_NAME=$(echo $REMOTE_URL | sed -E 's/(git@github\.com:|https:\/\/github\.com\/)([^\/]+)\/([^.]+)\.git/\2\/\3/')
   
   # 调用GitHub API查询隐私状态
   RESPONSE=$(curl -s -H "Authorization: token $GITHUB_TOKEN" "https://api.github.com/repos/$REPO_FULL_NAME")
   IS_PRIVATE=$(echo $RESPONSE | jq -r .private)
   
   if [ "$IS_PRIVATE" != "true" ]; then
       echo "❌ 错误：尝试推送到公开仓库！推送已终止。"
       exit 1
   fi
   
   exit 0
   

3. 添加可执行权限：
   同样运行chmod +x .git/hooks/pre-push赋予执行权限。

让团队成员同步钩子配置 #

由于.git/hooks目录不会被Git版本控制，要让所有成员都用上这个钩子，可以：

• 在仓库根目录创建scripts文件夹，把pre-push脚本放在这里并提交到仓库；
• 让团队成员运行以下命令，指定Git从scripts目录读取钩子：

  git config core.hooksPath scripts/
  

测试验证 #

临时将仓库设为公开，执行git push，会看到错误提示且推送失败；将仓库改回私有后，即可正常推送。

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