一文教你告别git误提交:三步防止代码被提交到错误分支_其他编程

一、问题场景

在团队协作中，我们通常会约定 master 或 main 作为主分支，sit 作为测试分支，所有代码变更必须通过 pull request（pr）/ merge request（mr）合入，而不能直接提交或推送。

然而，在实际开发中，我们经常需要在多个分支之间来回切换。有时一忙起来，就忘了检查当前分支，直接在 sit 或master 上写代码并提交。等发现时，要么需要 git reset 撤销，要么更糟——已经推送了，只能重写一遍。

你的痛苦，我懂。

二、三层防护方案

要彻底解决这个问题，建议采用**“远程保护为主，本地提醒为辅”**的策略，层层设防：

层级	方案	作用	强制性
第一层	远程分支保护（gitee/github）	从源头阻止推送到受保护分支	⭐⭐⭐ 最强
第二层	idea 本地受保护分支	ide 层面禁用 push 按钮	⭐⭐ 中等
第三层	git pre-commit 钩子	本地 commit 前拦截	⭐ 辅助提醒

第一层：远程分支保护（最根本的保障）

这是最可靠的方案，在远程仓库层面设置规则，从源头阻止不合规的推送。

gitee 设置步骤

进入仓库设置：登录 gitee，进入你的仓库页面，点击顶部导航栏的 「管理」。
找到分支保护：在左侧菜单中，点击 「保护分支设置」。
新建保护规则：点击 「新建规则」 或 「添加分支保护」 按钮。
配置保护规则：
- 分支名称：输入你要保护的分支名，如 master 或 main。
- 保护级别：选择 「保护分支」 或 「评审模式」。
- 禁止直接推送：勾选 「禁止任何人推送」 或 「禁止强制推送」。
- 要求 pull request：启用后，所有代码必须通过 pr 才能合并。
- 审查者要求：可选择要求至少 1 个 reviewer 审核。
保存规则：点击确认，规则即刻生效。

设置完成后，任何直接 git push 到该分支的尝试都会被远程仓库拒绝。

github 设置步骤

进入仓库，点击 settings → branches。
点击 add branch protection rule。
在 branch name pattern 中输入 master 或 main。
勾选 require a pull request before merging。
勾选 do not allow force pushes。
点击 create 保存。

第二层：intellij idea 本地受保护分支

这个设置能让 idea 在本地给你一个视觉提醒，并禁用 push 按钮，防止误操作。

打开设置：file → settings（windows/linux）或 intellij idea → preferences（macos）。
导航到：version control → git。
在 「protected branches」 区域，点击 + 号，输入你要保护的分支名（如 master、main）。
点击 apply 或 ok 保存。

设置后，idea 会禁用对该分支的 push 按钮，并灰化修改历史的相关操作。

提示：如果远程仓库（如 github）已设置分支保护，idea 会在你 checkout 该分支时自动将其标记为受保护分支。

第三层：git pre-commit 钩子（最后一道防线）

这是一个在本地 git commit 前自动执行的脚本，是阻止你犯错的一道额外保险。

单分支版本

进入项目的 .git/hooks/ 目录，创建 pre-commit 文件（无扩展名），内容如下：

#!/bin/sh
branch="$(git rev-parse --abbrev-ref head)"
if [ "$branch" = "master" ] || [ "$branch" = "main" ]; then
  echo "❌ 当前分支 $branch 不允许直接提交，请创建分支后发起合并请求。"
  exit 1
fi

保存后，在终端执行 chmod +x .git/hooks/pre-commit 赋予执行权限。

多分支版本（回答你的问题）

如果你有多个分支需要保护（如 master、main、develop、release 等），可以这样写：

#!/bin/sh

# 获取当前分支名
branch="$(git rev-parse --abbrev-ref head)"

# 定义需要保护的分支列表（用空格分隔）
protected_branches="master main develop release"

# 检查当前分支是否在保护列表中
for protected in $protected_branches; do
  if [ "$branch" = "$protected" ]; then
    echo "❌ 当前分支 $branch 不允许直接提交，请创建分支后发起合并请求。"
    exit 1
  fi
done

# 如果不在保护列表中，正常提交
exit 0

脚本说明：

protected_branches="master main develop release"：在这里添加所有需要保护的分支名，用空格分隔。
for protected in $protected_branches：循环遍历保护列表，逐一匹配当前分支。
如果匹配成功，输出提示信息并阻止提交（exit 1）。
如果都不匹配，正常提交（exit 0）。

注意：pre-commit 钩子只影响你自己的本地环境，且可以通过 git commit --no-verify 跳过，因此不能替代远程保护。

使用 pre-commit 框架（进阶方案）

如果你希望更规范地管理 git 钩子，可以使用 pre-commit 框架。它内置了 no-commit-to-branch 钩子。

1.安装 pre-commit：pip install pre-commit

2.在项目根目录创建 .pre-commit-config.yaml：

repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.5.0
    hooks:
      - id: no-commit-to-branch
        args: ['--branch', 'master', '--branch', 'main', '--branch', 'develop']

3.安装钩子：pre-commit install

这个方案的优势是团队共享——所有成员都能使用相同的钩子配置。

三、方案对比与选择建议

方案	优点	缺点	推荐度
远程分支保护	强制生效，无法绕过	需要仓库管理员权限	⭐⭐⭐⭐⭐ 必做
idea 受保护分支	视觉提醒直观，操作简单	仅限 idea 用户，可被绕过	⭐⭐⭐⭐ 推荐
pre-commit 钩子	本地拦截，即时反馈	可被 `--no-verify` 跳过	⭐⭐⭐ 辅助