# 引用規格
縱觀全書,我們已經使用過一些諸如遠程分支到本地引用的簡單映射方式,但這種映射可以更復雜。 假設你添加了這樣一個遠程版本庫:
~~~
$ git remote add origin https://github.com/schacon/simplegit-progit
~~~
上述命令會在你的?`.git/config`?文件中添加一個小節,并在其中指定遠程版本庫的名稱(`origin`)、URL 和一個用于獲取操作的引用規格(refspec):
~~~
[remote "origin"]
~~~
引用規格的格式由一個可選的?`+`?號和緊隨其后的?`<src>:<dst>`?組成,其中?`<src>`?是一個模式(pattern),代表遠程版本庫中的引用;`<dst>`?是那些遠程引用在本地所對應的位置。?`+`?號告訴 Git 即使在不能快進的情況下也要(強制)更新引用。
默認情況下,引用規格由?`git remote add`?命令自動生成, Git 獲取服務器中?`refs/heads/`下面的所有引用,并將它寫入到本地的?`refs/remotes/origin/`?中。 所以,如果服務器上有一個?`master`?分支,我們可以在本地通過下面這種方式來訪問該分支上的提交記錄:
~~~
$ git log origin/master
$ git log remotes/origin/master
$ git log refs/remotes/origin/master
~~~
上面的三個命令作用相同,因為 Git 會把它們都擴展成?`refs/remotes/origin/master`。
如果想讓 Git 每次只拉取遠程的?`master`?分支,而不是所有分支,可以把(引用規格的)獲取那一行修改為:
~~~
fetch = +refs/heads/master:refs/remotes/origin/master
~~~
這僅是針對該遠程版本庫的?`git fetch`?操作的默認引用規格。 如果有某些只希望被執行一次的操作,我們也可以在命令行指定引用規格。 若要將遠程的?`master`?分支拉到本地的`origin/mymaster`?分支,可以運行:
~~~
$ git fetch origin master:refs/remotes/origin/mymaster
~~~
你也可以指定多個引用規格。 在命令行中,你可以按照如下的方式拉取多個分支:
~~~
$ git fetch origin master:refs/remotes/origin/mymaster \
topic:refs/remotes/origin/topic
From git@github.com:schacon/simplegit
! [rejected] master -> origin/mymaster (non fast forward)
* [new branch] topic -> origin/topic
~~~
在這個例子中,對?`master`?分支的拉取操作被拒絕,因為它不是一個可以快進的引用。 我們可以通過在引用規格之前指定?`+`?號來覆蓋該規則。
你也可以在配置文件中指定多個用于獲取操作的引用規格。 如果想在每次獲取時都包括?`master`?和`experiment`?分支,添加如下兩行:
~~~
[remote "origin"]
~~~
我們不能在模式中使用部分通配符,所以像下面這樣的引用規格是不合法的:
~~~
fetch = +refs/heads/qa*:refs/remotes/origin/qa*
~~~
但我們可以使用命名空間(或目錄)來達到類似目的。 假設你有一個 QA 團隊,他們推送了一系列分支,同時你只想要獲取?`master`?和 QA 團隊的所有分支而不關心其他任何分支,那么可以使用如下配置:
~~~
[remote "origin"]
~~~
如果項目的工作流很復雜,有 QA 團隊推送分支、開發人員推送分支、集成團隊推送并且在遠程分支上展開協作,你就可以像這樣(在本地)為這些分支創建各自的命名空間,非常方便。
## 引用規格推送
像上面這樣從遠程版本庫獲取已在命名空間中的引用當然很棒,但 QA 團隊最初應該如何將他們的分支放入遠程的?`qa/`?命名空間呢? 我們可以通過引用規格推送來完成這個任務。
如果 QA 團隊想把他們的?`master`?分支推送到遠程服務器的?`qa/master`?分支上,可以運行:
~~~
$ git push origin master:refs/heads/qa/master
~~~
如果他們希望 Git 每次運行?`git push origin`?時都像上面這樣推送,可以在他們的配置文件中添加一條?`push`?值:
~~~
[remote "origin"]
~~~
正如剛才所指出的,這會讓?`git push origin`?默認把本地?`master`?分支推送到遠程`qa/master`?分支。
## 刪除引用
你還可以借助類似下面的命令通過引用規格從遠程服務器上刪除引用:
~~~
$ git push origin :topic
~~~
因為引用規格(的格式)是?`<src>:<dst>`,所以上述命令把?`<src>`?留空,意味著把遠程版本庫的?`topic`?分支定義為空值,也就是刪除它。
- 前言
- Scott Chacon 序
- Ben Straub 序
- 獻辭
- 貢獻者
- 引言
- 1. 起步
- 1.1 關于版本控制
- 1.2 Git 簡史
- 1.3 Git 基礎
- 1.4 命令行
- 1.5 安裝 Git
- 1.6 初次運行 Git 前的配置
- 1.7 獲取幫助
- 1.8 總結
- 2. Git 基礎
- 2.1 獲取 Git 倉庫
- 2.2 記錄每次更新到倉庫
- 2.3 查看提交歷史
- 2.4 撤消操作
- 2.5 遠程倉庫的使用
- 2.6 打標簽
- 2.7 Git 別名
- 2.8 總結
- 3. Git 分支
- 3.1 分支簡介
- 3.2 分支的新建與合并
- 3.3 分支管理
- 3.4 分支開發工作流
- 3.5 遠程分支
- 3.6 變基
- 3.7 總結
- 4. 服務器上的 Git
- 4.1 協議
- 4.2 在服務器上搭建 Git
- 4.3 生成 SSH 公鑰
- 4.4 配置服務器
- 4.5 Git 守護進程
- 4.6 Smart HTTP
- 4.7 GitWeb
- 4.8 GitLab
- 4.9 第三方托管的選擇
- 4.10 總結
- 5. 分布式 Git
- 5.1 分布式工作流程
- 5.2 向一個項目貢獻
- 5.3 維護項目
- 5.4 總結
- 6. GitHub
- 6.1 賬戶的創建和配置
- 6.2 對項目做出貢獻
- 6.3 維護項目
- 6.4 管理組織
- 6.5 腳本 GitHub
- 6.6 總結
- 7. Git 工具
- 7.1 選擇修訂版本
- 7.2 交互式暫存
- 7.3 儲藏與清理
- 7.4 簽署工作
- 7.5 搜索
- 7.6 重寫歷史
- 7.7 重置揭密
- 7.8 高級合并
- 7.9 Rerere
- 7.10 使用 Git 調試
- 7.11 子模塊
- 7.12 打包
- 7.13 替換
- 7.14 憑證存儲
- 7.15 總結
- 8. 自定義 Git
- 8.1 配置 Git
- 8.2 Git 屬性
- 8.3 Git 鉤子
- 8.4 使用強制策略的一個例子
- 8.5 總結
- 9. Git 與其他系統
- 9.1 作為客戶端的 Git
- 9.2 遷移到 Git
- 9.3 總結
- 10. Git 內部原理
- 10.1 底層命令和高層命令
- 10.2 Git 對象
- 10.3 Git 引用
- 10.4 包文件
- 10.5 引用規格
- 10.6 傳輸協議
- 10.7 維護與數據恢復
- 10.8 環境變量
- 10.9 總結
- A. 其它環境中的 Git
- A1.1 圖形界面
- A1.2 Visual Studio 中的 Git
- A1.3 Eclipse 中的 Git
- A1.4 Bash 中的 Git
- A1.5 Zsh 中的 Git
- A1.6 Powershell 中的 Git
- A1.7 總結
- B. 將 Git 嵌入你的應用
- A2.1 命令行 Git 方式
- A2.2 Libgit2
- A2.3 JGit
- C. Git 命令
- A3.1 設置與配置
- A3.2 獲取與創建項目
- A3.3 快照基礎
- A3.4 分支與合并
- A3.5 項目分享與更新
- A3.6 檢查與比較
- A3.7 調試
- A3.8 補丁
- A3.9 郵件
- A3.10 外部系統
- A3.11 管理
- A3.12 底層命令