git pull upstream同步上游更新

在使用git管理项目的时候，不管是gitlab还是github项目，都可以通过fork将上游仓库的项目复制到自己仓库中，但是上游的仓库变更时，怎么同步更新自己仓库里的变化呢？

一般有两种方式，一种方式是将上游的仓库提merge request到自己的仓库去合并；另一种方式是每次在修改自己仓库复制的项目之前，先通过git pull upstream master去同步上游项目的更新。

git pull origin与git pull upstream区别

git pull origin是拉取自己或团队项目的更新到本地；git pull upstream是拉取fork的外部上游项目的更新到本地自己仓库中的项目中。

git pull origin

origin指的是源仓库，一般为git clone的仓库，如xxx/fastjson，是克隆后默认提交和拉取的仓库地址。

git pull upstream

upstream意指上游仓库，一般是fork 出的上游仓库，如alibaba/fastjson。

fork操作

无论是github还是gitlab都有fork操作，该操作相当于把外部的仓库里面的项目复制到自己仓库下。例如，对alibaba/fastjson项目进行fork，会在自己仓库出现tomcat/fastjson项目，这里的tomcat代指自己github或gitlab的用户名。

git clone ssh://git@github.com/tomcat/fastjson.git
git pull // 默认是 git pull origin master，从bannidaer/fastjson的master分支拉代码
git pull upstream master // 从上游alibaba/fastjson的master分支拉代码

git pull upstream遇到 ‘upstream’ does not appear to be a git repository问题

在进行本地fork出的项目修改之前，想要先同步上游的更新，于是进行git pull upstream操作，出现如下问题：

fatal: 'upstream' does not appear to be a git repository
fatal: Could not read from remote repository.
 
Please make sure you have the correct access rights and the repository exists.

通过 git remote -v 检查，发现错误原因是 upstream repository 的地址是 ssh协议，而不是 https，并且没有指定upstream上游仓库地址而是自己origin的tomcat仓库。

origin  ssh://git@github.com/tomcat/fastjson.git (fetch)

解决方案：

如果想要使用https协议的仓库地址，可以利用 git remote remove upstream ssh://…仓库地址 的方式移除掉原来的 upstream repository，再 git remote add upstream https://… 添加上新的地址。

% git remote add upstream ssh://git@github.com/alibaba/fastjson.git
origin  ssh://git@github.com/tomcat/fastjson.git (fetch)             // 自己仓库的origin源项目
origin  ssh://git@github.com/tomcat/fastjson.git (push)
upstream        ssh://git@github.com/alibaba/fastjson.git (fetch)     // 外部上游仓库的项目
upstream        ssh://git@github.com/alibaba/fastjson.git (push)

添加完上游仓库地址后，再次执行git pull upstream命令如下：

% git pull upstream master
remote: Enumerating objects: 3, done.
remote: Counting objects: 100% (3/3), done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), 764 bytes | 76.00 KiB/s, done.
From ssh://git@github.com/alibaba/fastjson
 * branch            master     -> FETCH_HEAD
 * [new branch]      master     -> upstream/master
Updating xxxxxx
Fast-forward

由于之前配置了GOPRIVATE，项目中引用私有仓库的项目，就将之前https协议拉取代码的方式改成了ssh方式，这里指定ssh协议的上游仓库地址，如果你使用的是https协议可以指定https协议的上游仓库。

参考

Git:Origin和upstream的区别
‘git pull upstream master‘遇到的问题

GitHub 操作：同步 Fork 来的仓库

Fork 是 Github 上的常用操作之一，不同于 Star，Fork 会将进行 Fork 操作那一刻的仓库代码完全复制到自己的仓库下。Fork 之后，我们可能会为原仓库添加一个 Feature，之后发起 Pull Request。

往往在 Fork 之后，原仓库的作者也会进行代码更新，与我们自身的更新在 Git Commit 树中会分叉，如下图所示：

在某些这样的时候，我们发起的 Pull Request 是有冲突的。就算没有冲突，及时在发送 Pull Request 之前同步原仓库的代码也是十分必要的。本文将会介绍同步 Fork 原仓库代码的方法。

Step 1. 添加 upstream

我们首先要在 Git 中配置指向上游仓库（即 Fork 前的原本仓库）的远程仓库。

查看当前的 remote 情况：

$ git remote -v  # 列出当前的 remote 情况
> origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
> origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

添加上游仓库的地址：

$ git remote add upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git

验证:

$ git remote -v
> origin    https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
> origin    https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)
> upstream  https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (fetch)
> upstream  https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Step 2. 同步上游仓库代码

我们可以直接使用 git pull 命令同步 upstream 的指定分支即可。

为了更加保险，可使用 git pull --rebase 在本地解决可能发生的冲突。

Step 3. 上传到自己的仓库，发起PR

同步代码并解决冲突完成之后，可以将代码上传到自己的仓库中，并发起 Pull Request。

参考链接

• 为复刻配置远程仓库
• 同步复刻