Git 设置上游远程分支 - Shell/Bash

在使用 Git 进行团队协作开发时，我们通常会使用 Git 的分支特性，在本地创建分支，和远程仓库同步代码。在本地开发完成后，我们需要将本地分支合并到远程分支上。这时我们就需要设置上游远程分支，使用 Git 的 push 命令将代码推送到远程分支上。

设置上游远程分支主要步骤如下：

1. 查看当前的 Git 配置

可以使用 git remote -v 命令查看当前 Git 的远程仓库信息。

$ git remote -v
origin  https://github.com/user/repo.git (fetch)
origin  https://github.com/user/repo.git (push)

上述命令输出结果中，origin 就是 Git 的远程仓库名称，https://github.com/user/repo.git 是 Git 的远程仓库 URL，(fetch) 和 (push) 分别表示远程仓库的读写权限。

2. 添加上游远程分支

可以使用 git remote add 命令添加上游远程分支。

$ git remote add upstream https://github.com/otheruser/repo.git

上述命令中，upstream 就是上游远程仓库的名称，https://github.com/otheruser/repo.git 是上游远程仓库的 URL。

3. 确认上游远程分支

可以使用 git remote -v 命令确认上游远程仓库是否已经添加成功。

$ git remote -v
origin  https://github.com/user/repo.git (fetch)
origin  https://github.com/user/repo.git (push)
upstream  https://github.com/otheruser/repo.git (fetch)
upstream  https://github.com/otheruser/repo.git (push)

上述命令输出结果中，upstream 就是已经添加的上游远程仓库，具有读写权限。

4. 推送代码到上游远程分支

可以使用 git push 命令推送代码到上游远程分支。推送的格式为：

$ git push <上游远程仓库名称> <本地分支名称>:<上游远程分支名称>

例如，推送本地分支 dev 到上游远程分支 dev，命令如下：

$ git push upstream dev:dev

注意：在推送代码到上游远程分支之前，需要先将本地分支与上游远程分支进行合并，否则会出现代码冲突的问题。

以上就是 Git 设置上游远程分支的步骤。通过设置上游远程分支，我们可以便捷地推送代码到远程分支上，方便团队协作开发。

参考文献：

[1] Git - git-remote Documentation. https://git-scm.com/docs/git-remote. (accessed August 15, 2021)

[2] Git - git-push Documentation. https://git-scm.com/docs/git-push. (accessed August 15, 2021)