git show-branch命令的<glob>参数如何工作？为何使用时报错？

为什么你的命令会报错 #

• 对于git show-branch 10：Git会优先将不带通配符的参数尝试解析为commit SHA-1前缀或完整的分支/标签名称。当仓库中没有以10开头的commit SHA-1，也没有直接名为10的分支/标签时，就会抛出fatal: bad sha1 reference 10的错误。
• 对于git show-branch 10.*.x：虽然参数包含通配符，但你没有指定对应的ref命名空间路径（比如分支都在refs/heads/下），Git无法正确定位到分支所在的路径，同样会尝试解析为commit引用导致失败。

正确的glob匹配方式 #

git show-branch的glob模式是用来匹配refs/目录下的完整路径，使用时需要结合ref的命名空间（分支对应refs/heads/，标签对应refs/tags/）来编写规则：

• 匹配所有名称包含10的分支：

  git show-branch 'refs/heads/*10*'
  # 或简化写法（默认搜索分支空间）
  git show-branch 'heads/*10*'
  

• 匹配10.0.x、10.1.x这类分支：

  git show-branch 'refs/heads/10.*.x'
  # 或简化写法
  git show-branch 'heads/10.*.x'
  

• 对应文档中的例子：如果分支都在refs/heads/topic/目录下，git show-branch topic/*会匹配refs/heads/topic/*下的所有分支，这是因为Git默认会在refs/heads/空间下补全路径。

关键规则总结 #

• 当参数包含通配符（*、?、[]）时，Git会将其作为glob模式匹配refs/下的路径；
• 若参数不带通配符，Git会优先尝试解析为commit引用（SHA-1、分支/标签名），不会自动匹配包含该字符串的分支；
• 可以通过refs/heads/、refs/tags/等前缀明确指定要匹配的ref类型，避免歧义。

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