-
1. 起步
-
2. Git 基础
-
3. Git 分支
-
4. 服务器上的 Git
- 4.1 协议
- 4.2 在服务器上部署 Git
- 4.3 生成 SSH 公钥
- 4.4 架设服务器
- 4.5 Git Daemon
- 4.6 Smart HTTP
- 4.7 GitWeb
- 4.8 GitLab
- 4.9 第三方托管服务
- 4.10 小结
-
5. 分布式 Git
-
A1. 附录 A: Git 在其他环境
- A1.1 图形界面
- A1.2 Visual Studio 中的 Git
- A1.3 Visual Studio Code 中的 Git
- A1.4 IntelliJ / PyCharm / WebStorm / PhpStorm / RubyMine 中的 Git
- A1.5 Sublime Text 中的 Git
- A1.6 Bash 中的 Git
- A1.7 Zsh 中的 Git
- A1.8 PowerShell 中的 Git
- A1.9 小结
-
A2. 附录 B: 在应用程序中嵌入 Git
-
A3. 附录 C: Git 命令
10.5 Git 内部原理 - Refspec
Refspec
在本书中,我们一直使用从远程分支到本地引用的简单映射,但它们可以更为复杂。假设你一直跟着前几节操作并创建了一个小的本地 Git 仓库,现在想往其中添加一个远程仓库
$ git remote add origin https://github.com/schacon/simplegit-progit
运行上述命令会在你的仓库的 .git/config
文件中添加一个节,指定远程仓库的名称(origin
)、远程仓库的 URL 以及用于抓取的refspec
[remote "origin"]
url = https://github.com/schacon/simplegit-progit
fetch = +refs/heads/*:refs/remotes/origin/*
refspec 的格式是,首先是一个可选的 +
,后面跟着 <src>:<dst>
,其中 <src>
是远程端引用的模式,<dst>
是这些引用在本地将被跟踪的位置。+
告诉 Git 即使它不是一个快进(fast-forward)也要更新引用。
默认情况下,当执行 git remote add origin
命令时,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
的默认 refspec。如果你想只进行一次性的抓取,也可以在命令行上指定特定的 refspec。要将远程仓库上的 master
分支拉取到本地的 origin/mymaster
,你可以运行
$ git fetch origin master:refs/remotes/origin/mymaster
你也可以指定多个 refspec。在命令行上,你可以这样拉取多个分支
$ 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
分支的拉取被拒绝了,因为它没有被列为快进引用。你可以通过在 refspec 前面指定 +
来覆盖此行为。
你也可以在配置文件中为抓取指定多个 refspec。如果你想总是从 origin
远程仓库抓取 master
和 experiment
分支,添加两行
[remote "origin"]
url = https://github.com/schacon/simplegit-progit
fetch = +refs/heads/master:refs/remotes/origin/master
fetch = +refs/heads/experiment:refs/remotes/origin/experiment
从 Git 2.6.0 开始,你可以在模式中使用部分通配符(globs)来匹配多个分支,因此这也可以工作
fetch = +refs/heads/qa*:refs/remotes/origin/qa*
更好的是,你可以使用命名空间(或目录)来实现相同的目的,并且结构更清晰。如果你有一个 QA 团队推送一系列分支,并且你只想要获取 master
分支和 QA 团队的任何分支,而不需要其他分支,你可以使用这样的配置段
[remote "origin"]
url = https://github.com/schacon/simplegit-progit
fetch = +refs/heads/master:refs/remotes/origin/master
fetch = +refs/heads/qa/*:refs/remotes/origin/qa/*
如果你有一个复杂的工作流程,其中 QA 团队推送分支,开发人员推送分支,以及集成团队在远程分支上进行推送和协作,你可以通过这种方式轻松地为它们设置命名空间。
推送 Refspec
能够这样抓取带命名空间的引用固然很好,但 QA 团队最初是如何将他们的分支放入 qa/
命名空间的呢?你可以通过使用 refspec 进行推送来实现这一点。
如果 QA 团队想将他们的 master
分支推送到远程服务器上的 qa/master
,他们可以运行
$ git push origin master:refs/heads/qa/master
如果他们想让 Git 在每次运行 git push origin
时自动执行此操作,他们可以在其配置文件中添加一个 push
值
[remote "origin"]
url = https://github.com/schacon/simplegit-progit
fetch = +refs/heads/*:refs/remotes/origin/*
push = refs/heads/master:refs/heads/qa/master
同样,这将导致 git push origin
默认将本地的 master
分支推送到远程的 qa/master
分支。
注意
|
你不能使用 refspec 从一个仓库抓取并推送到另一个仓库。有关示例,请参阅 保持你的 GitHub 公共仓库最新。 |
删除引用
你也可以通过运行类似下面的命令来使用 refspec 从远程服务器删除引用
$ git push origin :topic
因为 refspec 的格式是 <src>:<dst>
,所以省略 <src>
部分,这基本上表示将远程仓库上的 topic
分支设为无,从而删除它。
或者你可以使用较新的语法(从 Git v1.7.0 起可用)
$ git push origin --delete topic