Team Foundation Server Git：提交至Parent分支前添加警告提示

嘿，这个问题我太懂了——团队里好几次有人不小心直接提交到Parent分支，打乱了整个PR评审流程，折腾半天回滚。下面给你几个实用的方案，从客户端到服务器端都有，能帮你把误操作的概率降到最低：

这个是在你本地提交代码前就触发的检查，能直接拦住误提交，或者弹出醒目的警告。每个开发者都需要配置一次：

1. 进入你的本地项目仓库，找到.git/hooks文件夹（默认是隐藏的）
2. 复制里面的pre-commit.sample文件，重命名为pre-commit（去掉.sample后缀）
3. 用编辑器打开这个文件，替换成下面的脚本（根据你的操作系统选）：

如果你用Mac/Linux（Bash脚本） #

#!/bin/sh
# 获取当前分支名
current_branch=$(git rev-parse --abbrev-ref HEAD)
# 替换成你的Parent分支名，比如"main"或者"develop"
parent_branch="main"

if [ "$current_branch" = "$parent_branch" ]; then
    echo "⚠️ 警告：你正在向Parent分支提交代码！"
    echo "请切换到对应的Child分支提交，然后通过PR合并到Parent分支。"
    # 如果你想直接阻止提交，把下面的注释去掉
    # exit 1
fi

保存后，记得给脚本加执行权限：chmod +x .git/hooks/pre-commit

如果你用Windows（PowerShell脚本） #

把pre-commit文件内容换成：

$currentBranch = git rev-parse --abbrev-ref HEAD
$parentBranch = "main" # 替换成你的Parent分支名

if ($currentBranch -eq $parentBranch) {
    Write-Host "⚠️ 警告：你正在向Parent分支提交代码！"
    Write-Host "请切换到对应的Child分支提交，然后通过PR合并到Parent分支。"
    # 要阻止提交就取消下面一行注释
    # exit 1
}

这样每次你在Parent分支提交时，都会弹出警告；如果打开了exit 1，直接就不让提交了。

客户端钩子毕竟可能被绕过（比如有人直接删除钩子文件），所以服务器端的保护才是最靠谱的。需要TFS管理员操作：

• 禁止直接提交权限：

  1. 打开TFS仓库的“分支”页面，找到Parent分支
  2. 右键点击Parent分支，选择“分支权限”
  3. 找到普通开发者的用户组，把“提交”权限设置为“拒绝”，只给管理员或者特定人员保留提交权限

• 要求必须通过PR合并：

  1. 同样在Parent分支的设置里，找到“分支策略”
  2. 开启“要求拉取请求才能合并”选项
  3. 还可以额外配置“需要至少1个评审人”“构建验证通过才能合并”等，进一步规范流程

这样一来，就算有人想直接推代码到Parent分支，TFS服务器会直接拒绝，必须走PR流程。

如果需要更灵活的服务器端检查（比如检查提交信息里是否包含Child分支关联的任务ID），可以配置TFS的服务器端钩子：

1. 登录TFS管理控制台，找到对应的仓库
2. 进入“设置”->“钩子”，添加一个“Pre-receive”钩子
3. 编写脚本检查推送的分支是否是Parent分支，如果是就返回错误信息，比如：

#!/bin/sh
while read oldrev newrev refname; do
    branch=$(git rev-parse --abbrev-ref "$refname")
    if [ "$branch" = "main" ]; then
        echo "❌ 禁止直接推送至Parent分支！请创建Child分支提交，然后通过PR合并。"
        exit 1
    fi
done

这个钩子会在代码推送到服务器前触发，直接拦截不符合要求的推送。

小建议 #

最好是客户端钩子+服务器端保护结合使用：客户端钩子提前给开发者预警，服务器端设置强制拦截，双重保险，基本就能杜绝误提交的问题了。

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