在參考中更新物件名稱

Created: November-22, 2018

使用

更新儲存在引用中的物件名稱

git update-ref [-m <reason>] (-d <ref> [<oldvalue>] | [--no-deref] [--create-reflog] <ref> <newvalue> [<oldvalue>] | --stdin [-z])

取消引用符號引用，將當前分支頭更新為新物件。
```
git update-ref HEAD <newvalue>
```
在驗證 ref 的當前值與 oldvalue 匹配後，將 newvalue 儲存在 ref 中。
```
git update-ref refs/head/master <newvalue> <oldvalue>
```
只有當前值為 oldvalue 時，上面的語法才會將 master 分支頭更新為 newvalue。

在驗證它仍包含 <oldvalue> 後，使用 -d 標誌刪除命名的 <ref>。

使用 --create-reflog，update-ref 將為每個 ref 建立一個 reflog，即使通常不會建立一個 reflog。

使用 -z 標誌以 NUL 終止格式指定，其格式包括 update，create，delete，verify。

如果給出，在驗證 <oldvalue> 之後將 <ref> 設定為 <newvalue>。指定零 <newvalue> 以確保更新後 ref 不存在和/或零 <oldvalue> 以確保在更新之前 ref 不存在。

在驗證它不存在後，用 <newvalue> 建立 <ref>。給定的 <newvalue> 可能不為零。

如果給出，在驗證它與 <oldvalue> 存在後刪除 <ref>。如果給出，<oldvalue> 可能不為零。

驗證 <ref> 對 <oldvalue> 但不改變它。如果 <oldvalue> 為零或缺失，則 ref 必須不存在。