超简单的详细教程：如何为一个GitHub开源项目做出贡献！

让我们通过一个具体的例子，详细了解如何从克隆一个GitHub仓库开始，一步步地贡献到一个项目。

文章共4,470字 · 阅读需要大约15分钟

一键AI生成摘要，助你高效阅读

问答

大局危危

1093人浏览 · 2024-01-06 21:57:40

大局危危 · 2024-01-06 21:57:40 发布

在这里插入图片描述
仓库：Ai-trainee/GPT-Prompts-Hub
让我们通过一个具体的例子，详细了解如何从克隆一个GitHub仓库开始，一步步地贡献到一个项目。以下是详细步骤，包括所需的代码和说明：

首先我们Fork想要贡献的项目，然后请看详细步骤：

1. 克隆仓库

首先，你需要在自己主页克隆这个“Fork的仓库”到本地计算机：

在GitHub上找到你想要克隆的仓库。
点击“Clone or download”按钮，复制仓库的URL。

然后，在你的计算机上打开命令行或终端，并运行以下命令来克隆仓库：

git clone <仓库URL>

例如：

git clone https://github.com/example-user/example-repo.git

这会在你的计算机上创建一个名为example-repo的文件夹，包含仓库的所有文件和历史记录。

2. 创建一个新分支

进入仓库的文件夹，并创建一个新分支进行你的工作。这个分支应该基于你想要修改的原始仓库的最新版本。

cd example-repo
git checkout -b <新分支名>

例如：

git checkout -b feature-branch

这会创建并切换到一个名为feature-branch的新分支。

3. 进行更改

在这个分支上，你可以开始进行你想要做的修改。这可能包括添加新文件、编辑现有文件等。

使用你喜欢的代码编辑器打开文件。
进行必要的更改。
保存你的更改。

4. 提交更改

完成更改后，你需要将这些更改提交到你的分支上。

首先，使用以下命令添加更改到暂存区：

git add .

然后，提交这些更改：

git commit -m "添加你的提交信息"

例如：

git commit -m "添加了新功能"

5. 推送更改到GitHub

提交更改后，你需要将这些更改推送到GitHub上你的分支。

git push origin <分支名>

例如：

git push origin feature-branch

6. 提交拉取请求（Pull Request）

返回到GitHub，进入你Fork的仓库页面。
你会看到一个“Compare & pull request”的按钮。点击它。
填写拉取请求的信息，说明你的更改，并提交。
在这里插入图片描述

7. 等待审查

项目维护者会审查你的拉取请求。他们可能会提出更改要求。

8. 进行必要的修改（如果有）

如果需要更改，回到你的本地仓库，进行修改，然后重复步骤4和5。

9. 合并到主项目（如果被接受）

如果你的拉取请求被接受，你的更改将被合并到主项目中。

这就是如何为一个GitHub项目做出贡献的过程。记住，每个项目可能有自己的特定规则和贡献指南，所以最好是先阅读这些指南。

文字版本再述

在GitHub上贡献第一个项目的过程可以分为几个步骤。我会用一个简单的比喻来解释每一步，以便更容易理解：

找到一个项目：首先，就像在图书馆找一本你感兴趣的书一样，你需要在GitHub上找到一个你感兴趣并且想要贡献的项目。你可以浏览GitHub，寻找开源项目，或者参与你目前正在使用的工具或软件的开发。
Fork项目：Fork就像是拿到这本书的一份复制件，并且你可以在上面做任何标记。在GitHub上，这意味着你创建了项目的一个个人副本，这样你就可以在不影响原始项目的情况下进行更改。
克隆项目到本地：这一步就像是把那本书带回家，在自己的空间里仔细研究。具体来说，你需要使用Git命令将项目复制到你的计算机上，这样你就可以在本地进行更改。
创建一个新分支：这就像是在你的笔记本上开辟一个新的章节来记录你对这本书的想法和更改。在软件开发中，创建一个分支意味着你在项目的一个独立的版本上工作，这样你的更改就不会直接影响主版本（通常被称为“master”或“main”分支）。
做出更改并提交：这就像是在你的笔记本上写下你的想法或对书的内容做一些更改。在软件术语中，这意味着在你的本地分支上编写代码或修改文件，并使用Git提交这些更改。
推送更改到GitHub：这一步就好比是你把你的笔记和想法分享给图书馆，让更多的人看到。具体来说，你需要使用Git命令把你的本地更改推送到GitHub上你Fork的项目副本。
提交拉取请求（Pull Request）：这就像是你向图书馆提交一个请求，建议他们将你的笔记或对书的更改加入到正式的藏书中。在GitHub上，这意味着你提交一个请求，让项目的维护者审查你的更改，并考虑将其合并到主项目中。
等待反馈：提交拉取请求后，项目的维护者会审查你的更改。这可能需要一些时间，就像图书馆需要时间来决定是否接受你的建议一样。
进行必要的修改：如果项目维护者有反馈或要求你做一些修改，这就像是图书馆告诉你需要对你的笔记做一些调整。根据反馈，你可能需要在你的分支上做出更改，并再次提交。
合并到主项目：如果你的更改被接受，它们会被合并到主项目中。这就像是你的笔记被图书馆认可并加入到书中，成为它的一部分。

仓库更新

针对我fork的项目，如果这个项目有变动，我仓库的项目会同步变动吗？我fork的项目已经有三个月了，现在我准备提交我第1次贡献，我直接克隆我仓库的这个项目吗
当你fork一个项目时，你fork的版本不会自动与原始项目同步更新。因此，如果原始项目有了更新，你的fork版本不会自动包含这些更新。如果你的fork已经有三个月没有更新了，而原始项目在此期间有所更改，你的fork可能已经落后于原始项目。

为了确保你的贡献基于最新的代码，你需要先将原始项目的更新合并到你的fork中。以下是如何做到这一点的步骤：

同步Fork与原始仓库

添加上游仓库：首先，你需要将原始仓库（你fork的项目的仓库）添加为一个新的远程仓库（通常称为“upstream”）。这样你就可以从这个仓库获取更新。在你的本地仓库中，运行以下命令：
```
git remote add upstream <原始仓库的URL>
```
例如：
```
git remote add upstream https://github.com/original-owner/original-repo.git
```
获取上游仓库的更改：接着，从上游仓库（原始仓库）获取最新的更改：
```
git fetch upstream
```
切换到你的主分支：确保你在自己fork的主分支上（通常是main或master）：
```
git checkout main
```
合并上游仓库的更改：将上游仓库的更改合并到你的主分支：
```
git merge upstream/main
```
或者，如果原始仓库的主分支是master：
```
git merge upstream/master
```
推送更改到你的GitHub Fork：最后，将这些更改推送到你的GitHub fork仓库：
```
git push origin main
```
或者，如果你的主分支是master：
```
git push origin master
```

准备贡献

现在你的fork已经同步了原始仓库的最新更改，你可以开始准备你的贡献。

克隆你的Fork：如果你还没有克隆你的fork到本地，可以这样做：
```
git clone https://github.com/your-username/your-fork.git
```
创建新分支：在你的本地仓库中创建一个新分支进行你的工作。
```
git checkout -b your-new-feature
```
进行更改、提交、推送：在这个新分支上进行你的更改，然后提交这些更改，并将它们推送到你的fork。
创建拉取请求（Pull Request）：在GitHub上对你的fork仓库，创建一个拉取请求到原始仓库，提交你的贡献。

很好，你已经成功创建了一个新分支并提交了更改。现在，我们将继续进行下一步：推送你的更改到GitHub上的远程分支，并提交一个拉取请求（Pull Request）。以下是详细步骤：

第4小步详细操作

推送更改到远程仓库

推送到远程分支：使用以下命令将你的本地分支推送到你的GitHub fork仓库。这个命令会在你的远程仓库中创建一个与本地分支同名的新分支。
```
git push -u origin aitrainee
```
这里，origin 是你fork仓库的远程名称，aitrainee 是你的本地分支名称。如果这个分支在远程仓库中尚不存在，该命令将创建它。

创建拉取请求（Pull Request）

打开GitHub：在你的浏览器中打开GitHub，并转到你的fork仓库页面。
新建拉取请求：你应该会在你的fork仓库页面看到一个“Compare & pull request”按钮。如果看到它，点击进入。如果没有看到，你可以手动发起拉取请求：
- 点击仓库中的“Pull requests”标签。
- 点击“New pull request”按钮。
- 选择比较分支（base repository 应该是原始仓库，base 应该是原始仓库你想合并的分支，通常是main或master；head repository 选择你的fork，compare 选择你的aitrainee分支）。
- 点击“Create pull request”。
填写拉取请求信息：在创建拉取请求的页面，添加一个标题和描述，清晰地描述你的更改和为什么要做这些更改。
提交拉取请求：检查一切无误后，点击“Create pull request”来正式提交你的拉取请求。

等待审查和反馈

审查和沟通：项目的维护者将审查你的拉取请求。他们可能会提出一些问题或要求更改。保持沟通，并根据反馈做出相应的调整。
最终合并：如果你的更改被接受，维护者将合并你的拉取请求到原始仓库。

通过这些步骤，你就能成功地推送你的更改到远程仓库，并创建一个拉取请求。记住，沟通和迅速响应项目维护者的反馈是这个过程的重要部分。祝你在开源贡献上成功！
通过这种方式，你可以确保你的贡献是基于最新的项目代码，从而增加你的更改被接受的可能性。
为了更深入地了解GitHub和开源贡献，你可以考虑研究以下几个方面：