git-reference/zh/remotes/index.html

---
layout: zh_reference
---

<div class="box">
  <h2>
    <span class="docs">
      <a target="new" href="http://progit.org/book/ch2-5.html">书</a>
    </span>
    分享与更新项目
  </h2>
  <div class="block">
    <p>
    Git 并不像 Subversion 那样有个中心服务器。目前为止所有的命令都是本地执行的，更新的知识本地的数据库。要通过 Git 与其他开发者合作，您需要将数据放到一台其他开发者能够连接的服务器上。Git 实现此流程的方式是将您的数据与另一个仓库同步。在服务器与客户端之间并没有实质的区别 —— Git 仓库就是 Git 仓库，您可以很容易地在两者之间同步。
    </p>

    <p>
    一旦您有了个 Git 仓库，不管它是在您自己的服务器上，或者是由 GitHub 之类的地方提供，您都可以告诉 Git 推送您拥有的远端仓库还没有的数据，或者叫 Git 从别的仓库把差别取过来。
    </p>

    <p>
    联网的时候您可以随时做这个，它并不需要对应一个 <code>commit</code> 或者别的什么。一般您会本地提交几次，然后从您的项目克隆自的线上的共享仓库提取数据以保持最新，将新完成的合并到您完成的工作中去，然后推送您的改动会服务器。
    </p>

    <p class="nutshell">
    <b>简而言之</b> 使用 <code>git fetch</code> 更新您的项目，使用 <code>git push</code> 分享您的改动。您可以用 <code>git remote</code> 管理您的远程仓库。
    </p>
  </div>
</div>

<div class="box">
  <h2>
    <span class="docs">
      <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-remote.html">文档</a> &nbsp;
      <a target="new" href="http://progit.org/book/ch2-5.html#showing_your_remotes">书</a>
    </span>
    <a name="remote">git remote</a>
    <span class="desc">罗列、添加和删除远端仓库别名</span>
  </h2>

  <div class="block">

    <p>不像中心化的版本控制系统（客户端与服务端很不一样），Git 仓库基本上都是一致的，并且并可以同步他们。这使得拥有多个远端仓库变得容易 —— 您可以可以拥有一些只读的仓库，另外的一些也可写的仓库。
    </p>

    <p>
    当您需要与远端仓库同步的时候，不需要使用它详细的链接。Git 储存了您感兴趣的远端仓库的链接的别名或者昵称。您可以使用 <code>git remote</code> 命令管理这个远端仓库列表。
    </p>

    <h4>
      git remote
      <small>列出远端别名</small>
    </h4>

    <p>
    如果没有任何参数，Git 会列出它存储的远端仓库别名了事。默认情况下，如果您的项目是克隆的（与本地创建一个新的相反），Git 会自动将您的项目克隆自的仓库添加到列表中，并取名“origin”。如果您执行时加上 <code>-v</code> 参数，您还可以看到每个别名的实际链接地址。
    </p>

<pre>
<b>$ git remote</b>
origin
<b>$ git remote -v</b>
origin	git@github.com:schacon/git-reference.git (fetch)
origin	git@github.com:schacon/git-reference.git (push)
</pre>

    <p>在此您看到了该链接两次，是因为 Git 允许您为每个远端仓库添加不同的推送与获取的链接，以备您读写时希望使用不同的协议。
    </p> 

    <h4>
      git remote add
      <small>为您的项目添加一个新的远端仓库</small>
    </h4>

    <p>
    如果您希望分享一个本地创建的仓库，或者您想要获取别人的仓库中的贡献 —— 如果您想要以任何方式与一个新仓库沟通，最简单的方式通常就是把它添加为一个远端仓库。执行 <code>git remote add [alias] [url]</code> 就可以。此命令将 <code>[url]</code> 以 <code>[alias]</code> 的别名添加为本地的远端仓库。
    </p>

    <p>
    例如，假设我们想要与整个世界分享我们的 Hello World 程序。我们可以在一台服务器上创建一个新仓库（我以 GitHub 为例子）。它应该会给您一个链接，在这里就是“git@github.com:schacon/hw.git”。要把它添加到我们的项目以便我们推送以及获取更新，我们可以这样：
    </p>

<pre>
<b>$ git remote</b>
<b>$ git remote add github git@github.com:schacon/hw.git</b>
<b>$ git remote -v</b>
github	git@github.com:schacon/hw.git (fetch)
github	git@github.com:schacon/hw.git (push)
</pre>

    <p>
    像分支的命名一样，远端仓库的别名是强制的 —— 就像“master”，没有特别意义，但它广为使用，因为 <code>git init</code> 默认用它；“origin”经常被用作远端仓库别名，就因为 <code>git clone</code> 默认用它作为克隆自的链接的别名。此例中，我决定给我的远端仓库取名“github”，但我叫它随便什么都可以。
    </p>

    <h4>
      git remote rm
      <small>删除现存的某个别名</small>
    </h4>

    <p>
    Git addeth and Git taketh away. 如果您需要删除一个远端 —— 不再需要它了、项目已经没了，等等 —— 您可以使用 <code>git remote rm [alias]</code> 把它删掉。
    </p>

<pre>
<b>$ git remote -v</b>
github	git@github.com:schacon/hw.git (fetch)
github	git@github.com:schacon/hw.git (push)
<b>$ git remote add origin git://github.com/pjhyett/hw.git</b>
<b>$ git remote -v</b>
github	git@github.com:schacon/hw.git (fetch)
github	git@github.com:schacon/hw.git (push)
origin	git://github.com/pjhyett/hw.git (fetch)
origin	git://github.com/pjhyett/hw.git (push)
<b>$ git remote rm origin</b>
<b>$ git remote -v</b>
github	git@github.com:schacon/hw.git (fetch)
github	git@github.com:schacon/hw.git (push)
</pre>

    <p class="nutshell">
    <b>简而言之</b> 您可以用 <code>git remote</code> 列出您的远端仓库和那些仓库的链接。您可以使用 <code>git remote add</code> 添加新的远端仓库，用 <code>git remote rm</code> 删掉已存在的那些。
    </p>

  </div>
</div>

<div class="box">
  <h2>
    <span class="docs">
      <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-fetch.html">文档</a> &nbsp;
      <a target="new" href="http://progit.org/book/ch2-5.html#fetching_and_pulling_from_your_remotes">书</a>
    </span>
    <a name="fetch">git fetch</a>
    <span class="desc">从远端仓库下载新分支与数据</span>
  </h2>

  <br/>

  <h2>
    <span class="docs">
      <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-pull.html">文档</a> &nbsp;
      <a target="new" href="http://progit.org/book/">书</a>
    </span>
    <a name="pull">git pull</a>
    <span class="desc">从远端仓库提取数据并尝试合并到当前分支</span>
  </h2>

  <div class="block">

    <p>
    Git 有两个命令用来从某一远端仓库更新。<code>git fetch</code> 会使您与另一仓库同步，提取您本地所没有的数据，为您在同步时的该远端的每一分支提供书签。这些分支被叫做“远端分支”，除了 Git 不允许您检出（切换到该分支）之外，跟本地分支没区别 —— 您可以将它们合并到当前分支，与其他分支作比较差异，查看那些分支的历史日志，等等。同步之后您就可以在本地操作这些。
    </p>

    <p>
    第二个会从远端服务器提取新数据的命令是 <code>git pull</code>。基本上，该命令就是在 <code>git fetch</code> 之后紧接着 <code>git merge</code> 远端分支到您所在的任意分支。我个人不太喜欢这命令 —— 我更喜欢 <code>fetch</code> 和 <code>merge</code> 分开来做。少点魔法，少点问题。不过，如果您喜欢这主意，您可以看一下 <code>git pull</code> 的 <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-pull.html">官方文档</a>。
    </p>

    <p>
    假设您配置好了一个远端，并且您想要提取更新，您可以首先执行 <code>git fetch [alias]</code> 告诉 Git 去获取它有您没有的数据，然后您可以执行 <code>git merge [alias]/[branch]</code> 以将服务器上的任何更新（假设有人这时候推送到服务器了）合并到您的当前分支。那么，如果我是与两三个其他人合作 Hello World 项目，并且想要将我最近连接之后的所有改动拿过来，我可以这么做：
    </p>

<pre>
<b>$ git fetch github</b>
remote: Counting objects: 4006, done.
remote: Compressing objects: 100% (1322/1322), done.
remote: Total 2783 (delta 1526), reused 2587 (delta 1387)
Receiving objects: 100% (2783/2783), 1.23 MiB | 10 KiB/s, done.
Resolving deltas: 100% (1526/1526), completed with 387 local objects.
From github.com:schacon/hw
   8e29b09..c7c5a10  master     -> github/master
   0709fdc..d4ccf73  c-langs    -> github/c-langs
   6684f82..ae06d2b  java       -> github/java
 * [new branch]      ada        -> github/ada
 * [new branch]      lisp       -> github/lisp
</pre>

    <p>
    可以看到自从上一次与远端仓库同步以后，又新赠或更新了五个分支。“ada”与“lisp”分支是新的，而“master”、“clang”与“java”分支则被更新了。在此例中，我的团队在合并入主分支之前，将提议的更新推送到远端分支以审核。
    </p>

    <p>您可以看到 Git 做的映射。远端仓库的主分支成为了本地的一个叫做“github/master”的分支。这样我就可以执行 <code>git merge github/master</code> 将远端的主分支和并入我的本地主分支。或者，我可以 <code>git log github/master ^master</code> 看看该分支上的新提交。如果您的远端仓库叫做“origin”，那远端主分支就会叫做 <code>origin/master</code>。几乎所有能在本地分支上执行的命令都可以在远端分支上用。
    </p>

    <p>
    如果您有多个远端仓库，您可以执行 <code>git fetch [alias]</code> 提取特定的远端仓库，或者执行 <code>git fetch --all</code> 告诉 Git 同步所有的远端仓库。
    </p>

    <p class="nutshell">
    <b>简而言之</b> 执行 <code>git fetch [alias]</code> 来将您的仓库与远端仓库同步，提取所有它独有的数据到本地分支以合并或者怎样。
    </p>

  </div>

</div>

<div class="box">
  <h2>
    <span class="docs">
      <a target="new" href="http://www.kernel.org/pub/software/scm/git/docs/git-push.html">文档</a> &nbsp;
      <a target="new" href="http://progit.org/book/ch2-5.html#pushing_to_your_remotes">书</a>
    </span>
    <a name="push">git push</a>
    <span class="desc">推送您的新分支与数据到某个远端仓库</span>
  </h2>

  <div class="block">
    <p>
    想要与他人分享您牛鼻的提交，您需要将改动推送到远端仓库。执行 <code>git push [alias] [branch]</code>，就会将您的 [branch] 分支推送成为 [alias] 远端上的 [branch] 分支。让我们试试推送我们的主分支到先前添加的“github”远端仓库上去。
    </p>

<pre>
<b>$ git push github master</b>
Counting objects: 25, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (25/25), done.
Writing objects: 100% (25/25), 2.43 KiB, done.
Total 25 (delta 4), reused 0 (delta 0)
To git@github.com:schacon/hw.git
 * [new branch]      master -> master
</pre>

    <p>
    挺简单。现在如果有人从该仓库克隆，他会得到我提交的完完全全的一份历史记录了。
    </p>

    <p>
    如果有个像之前创建的“erlang”分支那样的主题分支，想只分享这个，该怎么办呢？您可以相应的只推送该分支。
    </p>

<pre>
<b>$ git push github erlang</b>
Counting objects: 7, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (6/6), done.
Writing objects: 100% (6/6), 652 bytes, done.
Total 6 (delta 1), reused 0 (delta 0)
To git@github.com:schacon/hw.git
 * [new branch]      erlang -> erlang
</pre>

    <p>
    现在当人们从该仓库克隆时，他们就会得到一个“erlang”分支以查阅、合并。用这种方式，您可以推送任何分支到任何您有写权限的仓库。如果您的分支已经在该仓库中了，它会试着去更新，如果它不再，Git 会把它加上。
    </p>

    <p>
    最后一个当您推送到远端分支时会碰到的主要问题是，其他人在此期间也推送了的情况。如果您和另一个开发者同时克隆了，又都有提交，那么当她推送后您也想推送时，默认情况下 Git 不会让您覆盖她的改动。相反的，它会在您试图推送的分支上执行 <code>git log</code>，确定它能够在您的推送分支的历史记录中看到服务器分支的当前进度。如果它在在您的历史记录中看不到，它就会下结论说您过时了，并打回您的推送。您需要正式提取、合并，然后再次推送 —— 以确定您把她的改动也考虑在内了。
    </p>

    <p>
    当您试图推送到某个以被更新的远端分支时，会出现下面这种情况：
    </p>

<pre>
<b>$ git push github master</b>
To git@github.com:schacon/hw.git
 ! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to 'git@github.com:schacon/hw.git'
To prevent you from losing history, non-fast-forward updates were rejected
Merge the remote changes before pushing again.  See the 'Note about
fast-forwards' section of 'git push --help' for details.
</pre>

    <p>
    您可以修正这个问题。执行 <code>git fetch github; git merge github/master</code>，然后再推送
    </p>

    <p class="nutshell">
    <b>简而言之</b> 执行 <code>git push [alias] [branch]</code> 将您的本地改动推送到远端仓库。如果可以的话，它会依据您的 [branch] 的样子，推送到远端的 [branch] 去。如果在您上次提取、合并之后，另有人推送了，Git 服务器会拒绝您的推送，知道您是最新的为止。
    </p>

  </div>
</div>

<p><a href="/zh/inspect">到 检查与比较&#187;</a></p>