为什么git update-ref接受非/ refs引用？

Question

虽然像"git log"这样的命令会很乐意接受同一参考的不同表达式,例如

refs/heads/master
heads/master
master

对于"git update-ref",情况并非如此.例如

git update-ref master HEAD^

是不一样的

git update-ref refs/heads/master HEAD^

第一个命令创建一个新的ref .git/master(反过来引入了关于refs/heads/master的歧义).只有第二个命令真正更新了主人的脑袋.(git的/参/头/主)

为什么git update-ref接受没有"refs /"前缀的引用？是否应该至少有警告或命令行选项来强制创建此类引用？

我花了很长时间才弄明白为什么

git update-ref master HEAD^

没有按预期工作.

Answer 1

TL;博士

主要原因git log和git update-ref行为方式不同的原因是因为它git-log是一个高级命令 - 因此设计为用户友好的 - 而且git-update-ref是一个用于脚本的低级命令.

瓷器与管道

在Git的说法中,高级命令被称为瓷器,而低级命令被统称为管道.

瓷器命令旨在由人类交互使用,因此暴露了熟悉的高级概念,例如符号引用.另一方面,管道命令旨在以编程方式使用- 通常在脚本中 - 并允许直接操作Git的内部文件系统结构.

git的更新-REF

虽然git-log是能够解决的引用,git-update-ref-它是一个管道命令-解释的第一个参数无论是作为符号连接或一个普通的文件名取决于如何自行指定它.

从文档:

它只跟着真正的符号链接,如果它们以"refs /"开头:否则它只会尝试读取它们并将它们更新为常规文件.

这就是为什么如果你说git update-ref master <value>它将master视为文件名并在.git目录中创建它.同样的道理,当你说git update-ref HEAD <value>它将写入<value>到.git/HEAD文件中.