Windows下Git遇含特殊字符分支无法拉取推送，求永久解决方案

作为处理过多个跨OS大团队Git协作问题的开发者，我来分享几个经过验证的永久解决方案，完美适配你这种不能删除已有违规分支的场景：

一、从根源杜绝：给仓库加分支命名强制校验 #

既然团队里总有成员不小心用了Windows不支持的特殊字符，那直接在远程仓库（Bitbucket）层面把这条路堵死：

• 打开Bitbucket仓库的Settings > Branch restrictions，添加分支名称的正则匹配规则。推荐用这个正则：^[a-zA-Z0-9/_.-]+$，只允许字母、数字、下划线、斜杠、点、连字符，直接拒绝包含, :, >, =这类违规字符的分支创建请求。
• 再加一层保险：给仓库配置pre-receive钩子（Bitbucket支持自定义服务器端钩子），代码推送时自动校验分支名，不符合规范直接打回。钩子脚本示例：

#!/bin/bash
# 校验推送的分支名是否合法
while read oldrev newrev refname; do
    branch=$(git rev-parse --symbolic --abbrev-ref "$refname")
    # 匹配合法字符规则
    if [[ ! "$branch" =~ ^[a-zA-Z0-9/_.-]+$ ]]; then
        echo "❌ 错误：分支名 '$branch' 包含非法字符！仅允许字母、数字、_、/、.、-"
        exit 1
    fi
done
exit 0

这样不管是谁创建分支，只要不符合规范，远程仓库就会拒绝，从根源上避免新的违规分支出现。

二、兼容现有违规分支：Windows用户本地配置调整 #

对于已经存在的违规分支，Windows用户可以通过Git的内置配置绕过NTFS的文件名限制：

• 如果要对所有Git仓库生效，执行全局配置：

git config --global core.protectNTFS false

• 仅针对当前仓库生效的话，进入仓库目录执行：

git config core.protectNTFS false

这个配置会让Git在Windows本地存储分支引用时，自动把不合法的字符替换成URL编码的合法字符（比如把:换成%3A），这样就能正常执行pull、fetch、push操作了，而且不会修改远程分支的名称。

三、团队统一规范：把配置和规则落地 #

最后要把这些方案固化成团队协作规范：

• 在团队的Git入门文档里明确要求：所有Windows用户必须配置core.protectNTFS false，Linux/macOS用户无需调整；
• 把分支命名规则写入团队的协作指南，比如统一用feature/功能名、bugfix/问题编号这类格式，从习惯上避免使用特殊字符；
• 可以在团队的Git模板仓库里预先配置好core.protectNTFS，新成员克隆模板仓库时自动生效。

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