远程仓库

到目前为止，你的仓库只存在于一台电脑上的一个文件夹里。这足以保存历史，却无法与人共享，笔记本丢了也无法保住一份副本。为了这两件事，Git 使用远程仓库（remote）：同一个仓库在别处的其他副本，你的仓库可以与它们交换提交。

Git 是分布式的：仓库的每一份副本都是完整的，带有全部历史，对 Git 本身而言没有哪份副本是特殊的。实际工作中，团队会约定其中一份（通常放在 GitHub 这样的托管服务上）作为共享副本，大家都把工作发送到那里，也从那里取回工作。对你的仓库来说，那份副本就是一个有简短名字的远程仓库。最常用的名字是 origin：git clone 会给克隆来源的仓库起这个名字，大多数人自己添加远程仓库时也选用它。

有四条命令在你的仓库和远程仓库之间传递工作：

• git clone 为一个远程仓库创建新的本地副本，包含它的全部历史。
• git push 把你的新提交发送到远程仓库。
• git fetch 把远程仓库的新提交取回你的仓库，但不改变你自己的分支和文件。
• git pull 先获取，再把获取到的内容合并到你当前的分支。

为了记住远程仓库里有什么，你的仓库会保存一些远程跟踪分支（remote-tracking branch），名字类似 origin/main，意思是“上次查看时，main 在 origin 上的位置”。它们只在你获取、拉取或推送时移动。你自己的 main 只在你提交或合并时移动。

远程仓库不一定在另一台电脑上。只要 Git 能访问到的仓库都可以，包括你自己磁盘上的一个文件夹，而这正是最容易上手的学习方式。在本模块中，一个裸仓库（bare repository）充当服务器。裸仓库只有历史，没有工作区：没有人在里面编辑文件，所以别人可以安全地向它推送。按照惯例，它的文件夹名以 .git 结尾。

三条命令把你的仓库放到这个替身服务器上：

• git init --bare <path> 创建空的裸仓库。
• git remote add origin <path> 以 origin 这个名字把它告诉你的仓库。git remote -v 列出你的远程仓库及其地址。
• git push -u origin main 把 main 推送过去。-u（--set-upstream 的简写）还会把 origin/main 记录为你的 main 的上游（upstream），这样以后直接运行 git push 或 git pull 时，Git 就知道该去哪里。

在本系列页面中，服务器位于一个名为 /srv/git 的文件夹。你无法在自己的电脑上创建这个文件夹，所以请把替身放在你的 recipes 文件夹旁边。在 recipes 中运行 git init --bare ../server/recipes.git。Git 会创建 server 文件夹，并打印新仓库的完整路径，例如 /Users/you/server/recipes.git/ 或 C:/Users/you/server/recipes.git/。页面上凡是出现 /srv/git/recipes.git 的地方，请改用这个路径。如果路径中含有空格，请给它加上引号。

git init --bare /srv/git/recipes.git

Initialized empty Git repository in /srv/git/recipes.git/

git remote add origin /srv/git/recipes.git

git remote -v

origin	/srv/git/recipes.git (fetch)
origin	/srv/git/recipes.git (push)

git push -u origin main

To /srv/git/recipes.git
 * [new branch]      main -> main
branch 'main' set up to track 'origin/main'.

git status

On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

* 8bf3c2d (HEAD -> main, origin/main) Add a pancake recipe
* 907a979 Add a README

git init --bare 报告创建了一个新的空仓库。git remote add 什么也不打印，随后 git remote -v 把 origin 列出两次：一次作为获取的地址，一次作为推送的地址。两者通常相同。

git push -u origin main 报告了推送的目的地（To /srv/git/recipes.git）以及推送的内容：* [new branch] main -> main 表示你的 main 在远程仓库上创建了一个名为 main 的分支，那里之前没有这个分支。最后一行确认了上游。从现在起，git status 会与上游比较，并显示 Your branch is up to date with ‘origin/main’。提交图在 main 旁边显示了新标签 origin/main，两者位于同一次提交上。

现在又有人加入了。Sam 还没有食谱的副本。git clone <address> 会创建一份：它新建一个以仓库命名的文件夹（这里由 recipes.git 得到 recipes），把所有提交复制进去，检出默认分支，并把 origin 设置为指回这个地址。不需要 git init、git remote add 或 -u；克隆会把这些都做好。

在这个动手环节中，Sam 在自己的文件夹里克隆。在本系列页面中，每个人都有一个主文件夹，即 /home/alex 或 /home/sam，动手环节可以以其中任何一人的身份操作。

git clone /srv/git/recipes.git

Cloning into 'recipes'...
done.

cd recipes

ls

README.md  pancakes.md

git log --oneline

8bf3c2d Add a pancake recipe
907a979 Add a README

git remote -v

origin	/srv/git/recipes.git (fetch)
origin	/srv/git/recipes.git (push)

git branch -a

* main
  remotes/origin/HEAD -> origin/main
  remotes/origin/main

* 8bf3c2d (HEAD -> main, origin/main, origin/HEAD) Add a pancake recipe
* 907a979 Add a README

git clone 说明了它正在做什么：Cloning into 'recipes'...，然后是 done.。Sam 的文件夹中现在有同样的文件，git log --oneline 也显示同样的提交，哈希与 Alex 的完全相同：同一次提交在每份副本中都是同一次提交。

git remote -v 显示克隆已经知道自己的 origin。git branch -a（a 表示 all，全部）除了本地分支，还会列出远程跟踪分支。Sam 有一个本地分支 main，以及 remotes/origin 下的两项：分支 origin/main，以及记录远程仓库默认分支的 origin/HEAD。你可以忽略 origin/HEAD；本系列的提交图也不画它。Sam 的 main 已经把 origin/main 作为上游，所以 Sam 可以直接推送和拉取。

Alex 加入了一份柠檬蛋糕食谱并推送了它。Sam 怎样才能拿到呢？不会自动拿到：只有当你运行需要与远程仓库通信的命令时，Git 才会与它通信。在那之前，Sam 的仓库完全不知道有什么变化。

git fetch 向远程仓库索要你还没有的提交。它把这些提交存进你的仓库，并移动 origin/main 这样的远程跟踪分支，使其与远程仓库一致。除此之外它什么也不改：不改你的分支，也不改你的文件。你可以先看看取回了什么，再决定怎么处理。

git pull 一次完成两步：先获取，再把上游分支（这里是 origin/main）合并到你当前的分支。如果你的分支没有自己的新提交，这次合并就是快进，和第 4 模块中一样。

# Lemon cake

- 200 g flour
- 2 lemons

git add cake.md

git commit -m "Add a lemon cake recipe"

[main d5392e7] Add a lemon cake recipe
 1 file changed, 4 insertions(+)
 create mode 100644 cake.md

git push

To /srv/git/recipes.git
   8bf3c2d..d5392e7  main -> main

git status

On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

git fetch

From /srv/git/recipes
   8bf3c2d..d5392e7  main       -> origin/main

git status

On branch main
Your branch is behind 'origin/main' by 1 commit, and can be fast-forwarded.
  (use "git pull" to update your local branch)

nothing to commit, working tree clean

git log --oneline main..origin/main

d5392e7 Add a lemon cake recipe

* d5392e7 (origin/main, origin/HEAD) Add a lemon cake recipe
* 8bf3c2d (HEAD -> main) Add a pancake recipe
* 907a979 Add a README

git pull

Updating 8bf3c2d..d5392e7
Fast-forward
 cake.md | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 cake.md

ls

README.md  cake.md  pancakes.md

Alex 的 git push 显示的一行与第一次推送不同：8bf3c2d..d5392e7 main -> main 表示远程仓库上的 main 从 8bf3c2d 移到了 d5392e7。

再看 Sam 的两次 git status。获取之前，Git 显示 Your branch is up to date with ‘origin/main’，尽管 Alex 的提交已经在服务器上了。Git 只会把你的分支与你的仓库所知道的情况进行比较，而 Sam 的仓库还没有去问过。运行 git fetch（它报告 8bf3c2d..d5392e7 main -> origin/main）之后，状态变成了 Your branch is behind ‘origin/main’ by 1 commit, and can be fast-forwarded。

git log --oneline main..origin/main 列出 origin/main 有而 main 没有的提交：两个点的意思是“从右边能到达、从左边不能到达”。提交图显示了同样的情况：origin/main 比 main 领先一次提交。最后，git pull 快进了 main，ls 显示 Sam 的文件夹中有了 cake.md。

有时两个人先后推送，中间却没有获取。在下一个动手环节中，Alex 已经推送了蛋糕食谱，但 Sam 没有获取，就在旧的 main 之上提交了一份汤的食谱。于是 Sam 的推送失败了，因为远程仓库的 main 上有一次 Sam 的 main 所不包含的提交。接受这次推送就会丢掉 Alex 的提交，所以 Git 拒绝了它。补救办法是先把 Alex 的工作取回来并合并，然后再推送。

较新版本的 Git 还会请你做一次选择：当双方都有新提交时，git pull 应该怎样把你的工作与远程仓库的工作结合起来。在本系列中，你选择合并，和第 5 模块一样。这个动手环节展示了这个问题及其答案。

要跟着操作，请以 Alex 的身份提交一些内容并推送，然后在 Sam 的窗口中不先拉取就提交另外一些内容，再推送。

# Tomato soup

- 1 kg tomatoes

git add soup.md

git commit -m "Add a tomato soup recipe"

[main a128fc7] Add a tomato soup recipe
 1 file changed, 3 insertions(+)
 create mode 100644 soup.md

git push

To /srv/git/recipes.git
 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to '/srv/git/recipes.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

git pull

From /srv/git/recipes
   8bf3c2d..d5392e7  main       -> origin/main
hint: You have divergent branches and need to specify how to reconcile them.
hint: You can do so by running one of the following commands sometime before
hint: your next pull:
hint:
hint:   git config pull.rebase false  # merge
hint:   git config pull.rebase true   # rebase
hint:   git config pull.ff only       # fast-forward only
hint:
hint: You can replace "git config" with "git config --global" to set a default
hint: preference for all repositories. You can also pass --rebase, --no-rebase,
hint: or --ff-only on the command line to override the configured default per
hint: invocation.
fatal: Need to specify how to reconcile divergent branches.

git config --global pull.rebase false

git pull

Merge made by the 'ort' strategy.
 cake.md | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 cake.md

git push

To /srv/git/recipes.git
   d5392e7..642c9a6  main -> main

*   642c9a6 (HEAD -> main, origin/main, origin/HEAD) Merge branch 'main' of /srv/git/recipes
|\
| * d5392e7 Add a lemon cake recipe
* | a128fc7 Add a tomato soup recipe
|/
* 8bf3c2d Add a pancake recipe
* 907a979 Add a README

被拒绝的推送显示 ! [rejected] main -> main (fetch first)，提示信息解释了原因：远程仓库中有你本地没有的工作。双方都没有丢失或改变任何东西。

接着，第一次 git pull 取回了 Alex 的提交（8bf3c2d..d5392e7 main -> origin/main），但随后停了下来，显示 fatal: Need to specify how to reconcile divergent branches。Divergent（分叉）是指两个分支都有对方所没有的提交，就像三方合并那样。提示列出了三种设置：

• pull.rebase false 进行合并，就是你从第 4 模块以来一直在做的。
• pull.rebase true 进行变基（rebase），第 8 模块会解释。
• pull.ff only 只在可以快进时才拉取，否则拒绝。

git config --global pull.rebase false 为你的所有仓库选择合并，这样 Git 就不会再问了。第二次 git pull 随即完成合并，git push 也成功了。在你的电脑上，这次合并会打开编辑器，说明是 Merge branch 'main' of 后面跟着远程仓库的地址；像第 4 模块那样保存并关闭即可。提交图显示了结果：一次合并提交把 Sam 的汤食谱和 Alex 的蛋糕食谱连在一起，main 和 origin/main 位于同一次提交上。

如果两个人改动了相同的行，合并就会因冲突而停下。你要完全像第 5 模块那样解决冲突、提交，然后再推送。

替身服务器教会了你这些命令；托管服务则让仓库在任何地方都能访问。本节把你的食谱放到 GitHub 上。GitHub 的网页时有变化，所以具体的按钮请参照链接中的 GitHub 文档。Git 命令保持不变。

1. 创建账号：在 github.com 上按照在 GitHub 上创建账户操作。选一个你愿意公开的用户名：它会出现在你拥有的每个仓库的地址中。
2. 创建一个空仓库，命名为 recipes，按照创建新仓库操作。保持它为空：不要添加 README、许可证或 .gitignore，因为你的本地仓库已经有要推送的历史了。如果愿意，你可以把它设为私有。
3. 为 Git 设置登录。 GitHub 不接受用你的账户密码执行 Git 命令。最简单的安全做法是使用 GitHub CLI：安装它，运行 gh auth login，选择 GitHub.com 和 HTTPS，并在它询问是否用你的 GitHub 凭据为 Git 登录时选择同意。Git for Windows 自带 Git Credential Manager，你第一次推送时，它会打开浏览器窗口让你登录。在 Git 中缓存 GitHub 凭据介绍了这两种方式。有经验的用户常常改用 SSH 连接。
4. 把 origin 指向 GitHub 并推送。 先在你的 recipes 文件夹中运行 git pull，让它包含 Sam 在第 5 节中的工作。GitHub 在仓库页面上显示仓库的地址，形如 https://github.com/<username>/recipes.git。在你的 recipes 文件夹中运行：

git remote set-url origin https://github.com/<username>/recipes.git
git push -u origin main

git remote set-url 修改一个已有远程仓库的地址，于是 origin 现在指的是 GitHub，而不再是你的替身文件夹。git push -u 像之前一样发送你的历史并设置上游。刷新 GitHub 上的仓库页面：你的文件和提交都在那里了。从现在起，git push、git fetch 和 git pull 都与 GitHub 通信。

git clone /srv/git/recipes.git family-recipes

Cloning into 'family-recipes'...
done.

ls

family-recipes

cd family-recipes

git log --oneline

8bf3c2d Add a pancake recipe
907a979 Add a README

git switch -c soups

Switched to a new branch 'soups'

# Tomato soup

- 1 kg tomatoes

git add soup.md

git commit -m "Add a tomato soup recipe"

[soups 995e901] Add a tomato soup recipe
 1 file changed, 3 insertions(+)
 create mode 100644 soup.md

git push -u origin soups

To /srv/git/recipes.git
 * [new branch]      soups -> soups
branch 'soups' set up to track 'origin/soups'.

git branch -vv

  main  8bf3c2d [origin/main] Add a pancake recipe
* soups 995e901 [origin/soups] Add a tomato soup recipe

• Scott Chacon 和 Ben Straub，《Pro Git》，第 2.5 节：远程仓库的使用。
• git remote、git fetch、git pull 和 git push 的参考页面。
• GitHub 文档：将本地托管的代码添加到 GitHub 和关于远程仓库。