Git分支名称能否使用[]符号？使用时zsh报错应如何处理？

Git本身的分支命名规则不允许使用[符号，你当前遇到的报错优先是zsh的通配符机制触发的，还未到Git的规则校验环节。

报错原因 #

zsh默认开启文件名通配扩展功能，[]属于zsh的特殊通配符，用于匹配括号内指定范围内的任意单个字符。当你直接输入带[]的分支名作为Git命令参数时，zsh会先尝试用这段内容匹配当前目录下的文件，匹配不到就直接抛出zsh: no matches found: [#3]feature:filter错误，不会将参数传递给Git执行。

临时解决zsh报错的方法 #

如果你仅需要绕开当前的zsh报错，可以选择以下任意一种方式操作：

• 用引号包裹分支名，示例：git checkout "[#3]feature: filter"，单引号、双引号都可以，引号会告知zsh不对包裹内容做通配符解析
• 对特殊字符单独加反斜杠转义，示例：git checkout \[\#3\]feature:\ filter，转义后zsh会将这些符号识别为普通字符
• 如果你不想每次操作都做转义，可以在~/.zshrc配置文件中添加setopt nonomatch，执行source ~/.zshrc生效后，zsh匹配不到通配符对应文件时会直接将原始内容作为参数传递给命令，不会抛出匹配错误

长期建议 #

Git的分支命名规则明确禁止分支名包含[、]、~、^、:、?、*、\等特殊字符，以及连续的.、首尾/、末尾.等格式，就算你绕开了zsh的报错，调用Git时也会触发分支名校验失败的问题。建议你调整分支命名格式，比如将[#3]feature: filter修改为feature/#3-filter、#3-feature-filter这类符合Git规则的格式，避免后续出现各类兼容问题。

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