无同名分支标签时git checkout触发ambiguous警告的原因排查

结论正确性确认 #

你的推导结论完全正确。
Git在解析用户传入的简写引用名时，会同时遍历两类匹配对象：

• 所有已存在的引用（分支、标签、远程分支等）
• 所有Git对象（commit、tree、blob、annotated tag）的ID前缀
  当你输入的14198同时匹配到了本地分支14198、以及ID前缀为14198的blob对象时，就会触发歧义警告，warn_on_object_refname_ambiguity默认值为1就是负责控制该警告的触发逻辑，符合你排查到的现象。

关闭警告的方案 #

你可以选择以下任意一种方案处理：

• 更安全的无警告写法（推荐）：直接指定完整的引用路径，明确告知Git你要切换的是分支，不会触发歧义：

  git checkout refs/heads/14198
  

  如果你使用新版Git的专属分支切换命令switch，默认只会匹配分支，本身就不会触发该警告：

  git switch 14198
  

• 单次执行临时关闭警告：执行命令时传入临时配置参数即可：

  git -c advice.objectNameAmbiguity=false checkout 14198
  

• 全局/仓库维度永久关闭该类警告：执行对应配置命令即可：

  # 仅当前仓库生效
  git config advice.objectNameAmbiguity false
  # 全局所有仓库生效
  git config --global advice.objectNameAmbiguity false
  

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