git upstream

1. 什么是 Upstream？

在 Git 中，Upstream 是指当前项目所派生出的分支的原始仓库。这可以是一个远程仓库，也可以是本地仓库中的一个分支（通常称为源分支）。

在 Git 的分布式版本控制系统中，每个参与项目的开发者可以通过克隆存储库来获得源代码的完整副本。当某个开发者对代码进行修改并希望将其贡献到项目中时，Git 允许他们使用 Upstream 来与其他开发者分享和合并改动。

2. 使用 Upstream 的常见场景

2.1 同步远程仓库的最新代码

当您的项目与一个远程仓库保持同步时，您可能会发现自己需要定期获取远程仓库的最新代码。这对于团队合作和保持项目的最新状态非常重要。使用 Upstream 可以轻松实现这一目标。

步骤1：添加 Upstream 远程仓库

在我们开始使用 Upstream 来同步远程仓库的最新代码之前，我们需要将 Upstream 添加到我们的本地 Git 项目中。可以使用以下命令将一个远程仓库作为 Upstream 添加：

git remote add upstream <upstream-repository-url>

步骤2：抓取 Upstream 的最新代码

一旦 Upstream 成功添加到您的项目中，您就可以使用以下命令从 Upstream 获取最新的代码：

git fetch upstream

这将会将 Upstream 的最新代码更新到您的本地仓库，但不会自动合并这些更改。

步骤3：合并 Upstream 的最新代码

要将 Upstream 的最新代码合并到您的本地分支中，您可以使用以下命令：

git merge upstream/<branch-name>

请确保将<branch-name>替换为您要合并的实际分支的名称。这将会将 Upstream 分支的最新代码合并到您的本地分支中。

2.2 更新自己的分支并将更改合并到 Upstream

当您在自己的分支上进行开发，并希望将您的更改合并到 Upstream 时，您可以通过以下步骤实现。

步骤1：同步您的分支

在开始之前，您应该首先确保您的分支与 Upstream 的最新代码保持同步。这可以通过前面介绍的方法来实现。

步骤2：将更改推送到自己的远程分支

一旦您的分支与 Upstream 保持同步，您可以将您的更改推送到您自己的远程分支。使用以下命令：

git push origin <branch-name>

请将<branch-name>替换为您的实际分支名称。

步骤3：创建 Pull Request

接下来，您需要在 Upstream 仓库中创建一个 Pull Request，以便将您的更改合并到 Upstream。在 GitHub 上，您可以使用网页界面完成此操作。

打开 Upstream 仓库页面，切换到您要合并更改的分支，然后点击 “New Pull Request” 按钮。选择您的分支作为”Compare”分支，并填写 Pull Request 的相关信息。提交 Pull Request 后，项目维护者将会对您的更改进行审查，并根据情况接受或拒绝您的更改。