Hello World项目是计算机编程中历史悠久的传统。当你开始学习新东西时,这是一个简单的练习。让我们开始GitHub!
你将学习如何:
- 创建和使用一个存储库
- 开始和管理一个新的分支
- 对一个文件做出修改,并作为提交推到GitHub
- 打开并且合并一个pull request
GitHub是什么?
GitHub是一个用于版本控制和协作的代码托管平台。它可以让你和其他人在任何地方一起工作。
本教程教你GitHub的要点,如存储库、分支、提交和Pull Requests。你将创建自己的Hello World存储库,并学习GitHub的Pull Request工作流,这是一种创建和审查代码的流行方式。
无需必要的编码
要完成本教程,您需要GitHub.com帐户和互联网访问。你不需要知道如何编码、使用命令行或者安装Git (GitHub建立在其上的版本控制软件)。
提示:在一个单独的浏览器窗口(或选项卡)中打开这个指南,这样您就可以在完成教程中的步骤时看到它。
步骤1 创建一个存储库
存储库通常用于组织单个项目。存储库可以包含文件夹和文件、图像、视频、电子表格和数据集——项目所需要的任何东西。我们建议包含一个README文件或一个包含有关项目信息的文件。GitHub使得在你创建新的存储库的同时添加一个上述文件很容易。它还提供了其他常见的选项,如许可证文件。
你的hello-world存储库可以是你存储想法、资源甚至与他人分享和讨论事情的地方。
创建一个新的存储库
- 在右上角,你的头像或身份旁边,点击+,然后选择New repository。
- 将存储库命名为hello-world。
- 写一篇简短的描述。
- 选择带有README文件初始化这个存储库。
步骤2 创建一个分支
分支是同时处理存储库的不同版本的方法。
默认情况下,您的存储库有一个名为main的分支,它被认为是明确的分支。我们使用分支进行实验,并在提交给main之前进行编辑。
当您在main分支之外创建一个分支时,您正在创建一个main分支在当时的副本或快照。如果在您处理您的分支时,其他人对main分支进行了更改,您可以将这些更新拉入。
这个图表显示:
- main分支
- 一个名为feature的新分支(因为我们正在这个分支上做feature工作)
- feature在并入main之前所经历的旅程
你曾经保存过不同版本的文件吗?比如说:
story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
分支在GitHub库中实现类似的目标。
在GitHub上,我们的开发人员、编写人员和设计人员使用分支将错误修复和特性工作与我们的main(生产)分支分开。当一个变更准备好了,他们将其分支合并到main中。
创建一个新的分支
- 进入新的存储库hello-world。
- 单击文件列表顶部的下拉菜单,显示branch: main。
- 在新分支文本框中键入分支名称readme-edits。
- 选择蓝色的Create分支框或按键盘上的Enter键。
现在有了两个分支,main和readme-edits。它们看起来一模一样,但不会持续太久!接下来,我们将把更改添加到新分支中。
步骤3 做出和提交更改
万岁!现在,您进入了readme- editits分支的代码视图,它是main的副本。让我们做一些修改。
在GitHub上,保存的更改被称为提交。每个提交都有一个关联的提交消息,这是一个解释为什么进行特定更改的描述。提交消息捕获更改的历史,以便其他贡献者能够理解您做了什么以及为什么。
做出和提交更改
- 单击README.md文件。
- 单击文件视图右上角的铅笔图标进行编辑。
- 在编辑中,写一些关于你自己的东西。
- 编写一个提交消息来描述您的更改。
- 单击提交更改按钮。
这些更改将只对readme-editits分支上的README文件进行,因此现在这个分支包含与main不同的内容。
步骤4 打开Pull Request
漂亮的编辑!现在您已经在main分支中进行了更改,您可以打开一个pull请求。
Pull Requests是GitHub上协作的核心。当您打开一个拉入请求时,您是在建议您的更改,并请求某人检查并拉入您的贡献,并将它们合并到他们的分支中。Pull请求显示来自两个分支内容的差异。绿色和红色显示了变化、增加和减少。
一旦提交,就可以打开pull请求并开始讨论,甚至在代码完成之前。
通过在你的pull request消息中使用GitHub@mention系统,你可以从特定的人或团队寻求反馈,无论他们是在走廊下面还是10个时区之外。
您甚至可以在自己的存储库中打开pull requests并自己合并它们。这是一个学习GitHub流程的好方法,在忙于更大的项目之前。
打开一个Pull Request来更改README
点击图片查看大图
当您完成您的消息,单击创建Pull Request。
提示:你可以使用表情符号,拖放图片和gif到评论和Pull Requests。
第5步 合并你的Pull Request
在最后一步中,是时候将更改合并到一起了——将readme- edits分支合并到main分支中。
- 单击绿色的Merge pull request按钮将更改合并到main分支中。
- 点击Confirm merge。
- 继续并删除分支,因为它的更改已经合并,使用紫色框中的Delete branch按钮。
庆祝!
通过完成本教程,你已经学会了在GitHub上创建一个项目并做出一个pull request!
以下是你在本教程中所完成的:
- 创建一个开源库
- 启动并管理一个新的分支
- 改变一个文件并提交到GitHub
- 打开并合并一个Pull Request
看看你的GitHub档案,你会看到你的新贡献方块。
要了解更多Pull Requests的功能,我们推荐阅读GitHub流程指南。你也可以访问GitHub Explore并参与一个开源项目。
提示:查看我们的其他指南、YouTube频道和点播培训,了解更多关于如何开始使用GitHub的信息。