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

一、问题场景

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

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

你的痛苦，我懂。

二、三层防护方案

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

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

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

gitee 设置步骤

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

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

github 设置步骤

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

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

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

1. 打开设置：file → settings（windows/linux）或 intellij idea → preferences（macos）。
2. 导航到：version control → git。
3. 在 「protected branches」 区域，点击 + 号，输入你要保护的分支名（如 master、main）。
4. 点击 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

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

三、方案对比与选择建议

最佳实践：三层都配置上，形成“远程强制 + ide 提醒 + 本地拦截”的完整防护链。

四、总结

误提交到主分支是一个常见但完全可以避免的问题。通过本文介绍的三层防护方案：

1. 在 gitee/github 设置远程分支保护——这是最根本的保障，强制所有代码必须通过 pr 合入。
2. 在 intellij idea 配置本地受保护分支——ide 层面的提醒，让你在操作时就能看到警示。
3. 配置 git pre-commit 钩子——本地提交前的最后一道防线，多分支场景下也能轻松应对。

三层防护配合使用，让你彻底告别“代码白写了”的烦恼，专注于真正重要的编码工作。

到此这篇关于一文教你告别git误提交:三步防止代码被提交到错误分支的文章就介绍到这了,更多相关git防止提交错分支内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！