Git命令行语法解析：git branch模式匹配规则疑问

你的认知正确，该域名是Git官方维护的正式文档站点，所载内容为权威的官方说明。

你的三点理解存在核心遗漏，Git命令的模式匹配逻辑并非仅靠专属选项区分，位置参数的数量、语义优先级也会参与判定，不存在你提到的匹配歧义问题，具体说明如下：

• 首先，“8种模式完全互不重叠、所有选项仅归属单一模式”的结论不成立。文档将输出控制类的通用选项（比如--color、-v、--column等）列在第一种模式下，只是文档排版的简化处理，这类选项属于全局通用参数，可以在任意调用模式下使用，并非模式1独有。
• 其次，Git解析git branch命令的实际优先级逻辑非常清晰：
  1. 第一步先扫描命令行中的功能专属选项，命中即直接匹配对应模式：
     • 出现-u/--set-upstream-to匹配模式3（设置上游分支）
     • 出现--unset-upstream匹配模式4（取消上游分支绑定）
     • 出现-m/-M匹配模式5（重命名分支）
     • 出现-c/-C匹配模式6（复制分支）
     • 出现-d/-D匹配模式7（删除分支）
     • 出现--edit-description匹配模式8（编辑分支描述）
  2. 如果没有命中上述任何专属功能选项，再根据剩余位置参数的数量判定模式：
     • 无额外位置参数，或显式携带--list、-r、-a等列表类选项时，匹配模式1（列出分支），此时传入的位置参数会被当做分支名过滤通配符
     • 传入1个非选项参数时，参数会被优先识别为待创建的新分支名，直接匹配模式2（创建分支）。你举的git branch abcd1234-whatever例子就属于这个场景：执行后Git会直接尝试创建名为abcd1234-whatever的分支，不会把它当成列表过滤的匹配规则，不存在歧义
     • 传入2个非选项参数时，第二个参数会被识别为新分支的起始提交点，同样匹配模式2
• 最后需要说明：官方文档拆分的8种语法块是按使用场景做的可读性拆分，不是严格互斥的形式文法定义，不要用编译原理里上下文无关文法的严格互斥规则去套文档的排版逻辑。

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