github fork项目提交PR，并同步原始项目

2023-09-28 1,274 阅读3分钟

fork项目提交PR步骤

在 GitHub 中 fork 一个项目并提交修改到原始项目可以通过以下步骤完成：

第一步：Fork 原始项目

打开原始项目的 GitHub 页面。
点击右上角的 "Fork" 按钮。这将会把项目的一个副本复制到你的 GitHub 帐户下。

第二步：克隆 Fork 到本地

打开你 fork 的项目页面。
点击绿色的 "Code" 按钮，复制项目的仓库地址（可以选择使用 HTTPS 或者 SSH）。
在你的本地计算机上打开命令行终端（比如终端、命令提示符等）。
使用 git clone 命令来将 fork 的项目克隆到你的本地计算机中：
```
git clone <项目地址>
```
把 <项目地址> 替换成你在步骤 2 中复制的仓库地址。

第三步：在本地修改代码

进入克隆下来的项目目录。
对代码进行修改。

第四步：提交修改到你的 fork

使用以下命令将修改的文件添加到 Git 提交中：
```
git add .
```
使用以下命令提交修改：
```
git commit -m "描述你的修改"
```
把 "描述你的修改" 替换成对你的修改进行简要描述的文本。
使用以下命令将本地提交推送到你的 fork：
```
git push origin main
```
如果你使用的分支不是 main，请将命令中的 main 替换成你实际使用的分支名称。

第五步：创建一个 Pull Request (PR)

打开你 fork 的项目页面。
点击 "Pull Request" 标签页。
点击 "New pull request" 按钮。
在 "base repository" 中选择原始项目。
在 "base" 中选择你希望合并的分支（通常是 main）。
在 "compare" 中选择你的分支（通常是 main）。
点击 "Create pull request" 按钮。
给你的 PR 添加一个描述，然后点击 "Create pull request" 按钮。

第六步：等待审核和合并

维护者会检查你的修改并可能会提出一些建议。如果他们接受了你的修改，他们会将其合并到原始项目中。、请注意，你可能需要及时更新你的 fork，以便保持与原始项目同步。

与原始项目同步

要将你 fork 的仓库与原始仓库保持同步，可以通过以下步骤进行：

步骤一：将原始仓库添加为远程仓库

打开你 fork 的仓库所在的目录。
使用以下命令将原始仓库添加为一个远程仓库。你可以将 "upstream" 替换成你喜欢的名字，但通常习惯使用 "upstream"。
```
git remote add upstream <原始仓库地址>
```
例如：
```
git remote add upstream https://github.com/原始仓库的用户名/原始仓库的仓库名.git
```

步骤二：获取原始仓库的更新

使用以下命令获取原始仓库的最新代码：
```
git fetch upstream
```
这会将原始仓库的所有分支和提交下载到你的本地。

步骤三：合并原始仓库的更新

确保你在你 fork 的项目的主分支上：
```
git checkout main
```
如果你使用的分支不是 main，请将命令中的 main 替换成你实际使用的分支名称。
使用以下命令将原始仓库的更新合并到你的本地仓库中：
```
git merge upstream/main
```
这会将原始仓库的最新代码合并到你的本地分支中。

步骤四：将更新推送到你的 fork

使用以下命令将更新推送到你的 fork：
```
git push origin main
```
如果你使用的分支不是 main，请将命令中的 main 替换成你实际使用的分支名称。

现在，你的 fork 应该与原始仓库保持同步了。

参考