某天下午，我想拉一个包含多个系统名称的分支，用 & 作为连接符，结果命令刚敲完就报错了。排查之后发现，这不是 Git 的问题，而是 Shell 的锅。
一、问题复现
假设你执行了这样一条命令：
git checkout dev-add-aaa&bbb&ccc-featureA
Shell 在解析命令时，会把 & 理解为「将前面的进程放入后台运行」的信号，于是这一行命令被拆成了三段分别执行，根本没机会传给 Git。
二、Shell 特殊字符 vs Git 禁止字符
这里有一个容易混淆的概念需要区分：
| 层级 | 谁在限制 | 典型字符 | |
|---|---|---|---|
| Shell 层 | Bash / Zsh 等 Shell 解释器 | & ` | ; $ () <> !` |
| Git 层 | git check-ref-format 规则 | ~ ^ : ? * [ `` 空格 .. |
& 本身 Git 并不禁止，但 Shell 会在命令到达 Git 之前就将其截断，导致报错。
三、Git 官方分支命名规则
Git 通过 git check-ref-format 命令来校验引用名称，核心规则如下：
| 规则 | 示例 | 状态 |
|---|---|---|
| 不能包含空格 | feat new thing | 禁止 |
| 不能以 . 开头或包含 .. | .hidden / a..b | 禁止 |
| 不能以 .lock 结尾 | feature.lock | 禁止 |
| 不能包含 ~ ^ : ? * [ \ | feat~1 / fix:bug | 禁止 |
| 不能包含 @{ | feat@{0} | 禁止 |
| 不能以 / 结尾或包含 // | feat/ / a//b | 禁止 |
| 不能单独是 @ | @ | 禁止 |
| 字母、数字、- _ / | feat/add-login | 推荐 |
四、解决方案
方案 A：用引号包裹（不改分支名，立即生效）
双引号或单引号均可:
- git checkout "dev-add-aaa&bbb&ccc-insurance"
- git checkout 'dev-add-aaa&bbb&ccc-insurance'
引号告诉 Shell：这是一个整体字符串，不要做特殊解释。& 会原样传递给 Git。
方案 B：重命名分支（推荐，一劳永逸）
用短横线替代 &
- git branch -m "dev-add-aaa&bbb&ccc-insurance" dev-add-aaa-bbb-ccc-insurance
五、分支命名最佳实践
推荐只使用以下字符，跨平台、跨工具链零踩坑：
安全字符集 a-z 0-9 -（短横线） _（下划线） /（分组用） # 推荐命名格式
- feature/add-payment-gateway
- fix/260407-null-pointer-crash
- dev/260407-integrate-aaa-bbb-ccc
总结备忘
&报错是 Shell 的锅，不是 Git 的限制- 临时解决：用引号
"..."包裹整个分支名 - 长期建议：分支名只用
字母 / 数字 / - / _ / / - Git 真正禁止的字符：
~ ^ : ? * [ \ ..和空格 - 可用
git check-ref-format --branch <名称>验证合法性
