如何使用原生Git本地保护分支，防止意外提交至特定分支？

可以用原生Git的**钩子（hooks）**机制实现本地分支的提交/推送限制，完全不依赖GitHub等平台，且配置可移植。以下是两种实用方案：

方案1：禁止向特定本地分支提交（pre-commit钩子） #

如果想阻止自己意外向本地目标分支（比如main/master）提交代码，可创建pre-commit钩子：

1. 进入本地仓库的.git/hooks目录：

   cd .git/hooks
   

2. 创建并编辑pre-commit文件（若已有.sample后缀的同名文件，直接修改或替换即可）：

   nano pre-commit
   

3. 写入以下脚本（以禁止向main和master分支提交为例，可自行修改受保护分支列表）：

   #!/bin/bash
   
   CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
   PROTECTED_BRANCHES="main master"
   
   for BRANCH in $PROTECTED_BRANCHES; do
       if [ "$CURRENT_BRANCH" = "$BRANCH" ]; then
           echo "❌ 禁止向受保护分支 $BRANCH 提交代码"
           exit 1
       fi
   done
   
   exit 0
   

4. 给脚本添加执行权限：

   chmod +x pre-commit
   

之后只要你在main或master分支执行git commit，操作会被直接拦截并提示错误。

方案2：禁止向远程特定分支推送（pre-push钩子） #

如果允许本地提交，但想阻止意外推送到远程的受保护分支，可使用pre-push钩子：

1. 进入.git/hooks目录，创建pre-push文件：

   nano pre-push
   

2. 写入以下脚本（禁止推送到远程main和master分支，可自行调整分支列表）：

   #!/bin/bash
   
   PROTECTED_REMOTE_BRANCHES="main master"
   
   while read local_ref local_sha remote_ref remote_sha; do
       REMOTE_BRANCH=$(echo "$remote_ref" | sed 's/refs\/heads\///')
       for BRANCH in $PROTECTED_REMOTE_BRANCHES; do
           if [ "$REMOTE_BRANCH" = "$BRANCH" ]; then
               echo "❌ 禁止推送到远程受保护分支 $BRANCH"
               exit 1
           fi
       done
   done
   
   exit 0
   

3. 添加执行权限：

   chmod +x pre-push
   

当你尝试推送到远程main分支时，Git会直接拒绝操作。

可移植性优化 #

默认钩子文件存储在.git/hooks（不在仓库版本控制范围内），如果想让配置随仓库克隆一起携带：

• 在仓库根目录创建hooks文件夹，将钩子脚本放入其中
• 执行以下命令让Git读取这个目录的钩子：

  git config core.hooksPath hooks
  

之后把hooks目录加入仓库版本控制，其他人克隆后只需执行一次上述git config命令，就能复用分支保护配置。

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