GitHub 中文社区
论坛
排行榜
趋势
返回训练营

GitHub 快速入门课程

我们将在不到一小时的时间内学习如何使用GitHub

Welcome

欢迎来到 GitHub，人们使用 GitHub 构建一些世界上最先进的技术。 无论您是可视化数据还是开发新游戏，GitHub 上都有一个完整的社区和一套工具可以帮助您做得更好。 本课程将指导您在不到一个小时的时间内熟悉 GitHub 的使用。

  • 目标人群：初级开发者，GitHub 新用户，学生等
  • 课程目标：我们将认识什么是 “仓库(repositories)"，"分支"(branches)，"提交"(commits)，以及"拉取请求"(pull requests)
  • 你将构建：我们将制作一个简短的 Markdown 文件，您可将其作为您的 profile README（个人简介）.
  • 前置条件：注册GitHub账号
  • 学习时长：小于一个小时

通过本课程，您将

  1. 创建一个分支
  2. 提交一个文件
  3. 打开一个拉取请求
  4. 合并您的拉取请求

如何开始

start-course

  1. 右键点击上方 Start course 按钮

  2. 在新页面中根据系统提示新建一个仓库。

    • 仓库名称、描述这些字段系统已经帮我们自动填充好了，您可以按需修改。
    • 建议使用选择公共仓库，因为私有仓库 GitHub Action有免费额度限制
    • 最后点击 Create repository 按钮

  3. 仓库创建完毕后，等待大约 20 秒（等待Action执行），然后刷新页面。注意是刷新您仓库的页面，不是本课程的页面。如果页面没有变化，请继续等待。

接下来，我们将按照新建仓库中的README说明，进行分步操作。

步骤1：新建分支

什么是GitHub？：GitHub 是一个使用 Git 进行版本控制和协作的代码托管平台。GitHub 是一个共享和贡献开源软件的流行平台。
📺 Youtube视频：什么是 GitHub?

什么是仓库（Repository）？：仓库 是 GitHub 最基本的元素。 它们很容易被想象为项目的文件夹。 仓库包含所有项目文件（包括文档），并存储每个文件的修改历史记录。 仓库可以有多个协作者，仓库可以是公开的，也可以设置为私有的。详情介绍请查看GitHub 文档

什么是分支（Branch）？：分支是仓库的并行版本。默认情况下，您的仓库具有一个名为 main 的主分支。我们可以复制主分支创建其他分支，您安全地进行任何更改而不会影响”线上“主分支。 完成所需更改后，可以将分支合并回主分支以发布你的更改。

什么是profile README？：profile README 其实是您 GitHub 个人主页资料上 “关于我” 的介绍。 内容一般包含：

  • 介绍您的工作和兴趣
  • 您引以为豪的贡献以及这些贡献的背景信息
  • 在您参与的社区获得帮助的指南 profile README

⌨️ 练习：您的第一个分支

  1. 回到我们刚创建的仓库中
  2. 并确认是否在 < > Code 页面

code-tab

  1. 点击 main 分支

main-branch-dropdown

  1. 输入新分支名字: my-first-branch
  2. 点击 Create branch: my-first-branch 创建分支

create-branch-button

然后会自动切换到新创建的分支。

  1. 等待大约20秒，然后刷新页面。GitHub Actions 将自动更新到下一步。

步骤2：提交文件

恭喜您完成创建了一个分支🎉

创建分支的好处是我们可以随意修改项目而不会影响主分支。现在您创建了一个分支，是时候新建一个文件并完成您的第一次提交。

什么是提交(commit)？："提交“是指对项目中的文件或文件夹的一组修改。有关更多信息，请参阅“关于提交”。

⌨️ 练习：您的第一次提交

以下步骤将指导您完成在 GitHub 上提交修改的过程。 文件重命名、内容修改、创建新文件以及对项目所做的任何其他修改都会产生”提交“记录。 对于本练习，提交修改前我们需要首先在新分支中创建一个文件。

  1. 在 < > Code tab中首先确认当前是否处于 my-first-branch 分支。

  2. 选择 Add file 下拉框并点击Create new file创建一个文件

create new file option

  1. 在 Name your file... 输入框中输入文件名：PROFILE.md

    备注： .md 是 Markdown 格式文件的扩展名。 其语法格式可以阅读我们的文档基本撰写和格式语法

  2. 在编辑框内复制下面的文件内容：

    Welcome to my GitHub profile!
    profile.md file screenshot

  3. 点击右上角绿色按钮 "Commit changes..."。对于提交，您可以输入简短文字来描述您所做的更改。 此信息可帮助其他人了解您的提交中包含的内容。 GitHub 提供了一个简单的默认描述，但让我们稍微更改一下以进行练习。 首先，在第一个标题为“提交消息”的文本输入字段中输入 Add PROFILE.md。

    screenshot of adding a new file with a commit message

  4. 本节我们暂时不用关心其他选项，现在请点击 Commit changes 吧。

  5. 等待大约20秒，然后刷新页面。GitHub Actions 将自动更新到下一步。

步骤3：打开拉取请求（Open a pull request）

干的漂亮，您完成了一次提交！ ✨

什么是拉取请求(pull request)？： 拉取请求是 GitHub 上协作的核心。 拉取请求向他人展示你分支中发生的修改，并允许其他人接受、拒绝或者增加其他修改建议。 通过side by side 比较方式，显示两个分支中内容的差异，此拉取请求将保留您刚刚在分支上所做的修改，并提议将它们合并到main分支上。 更多关于拉取请求，请查看文档"About pull requests"

⌨️ 练习：创建拉取请求

您可能已经注意到，在提交后会显示一条消息，提示您最近推送到分支并显示了一个 “Compare & pull request” 的按钮。

screenshot of message and button

点击 Compare & pull request 会自动创建拉取请求，然后我们直接跳到下面的第6步。否则我们将手动创建，请跟随下面的说明。

  1. 点击顶部菜单 Pull requests tab

  2. 点击 New pull request

  3. base: 下拉框中请确保选择的是 main 分支

  4. 选择 compare: 下拉框，并点击 my-first-branch 分支

    screenshot showing both branch selections

  5. 点击 Create pull request

  6. 输入拉取请求的标题。 这里我们填 Add my first file

  7. 下面输入框中输入描述性的话，说明你做了那些修改

  8. 点击 Create pull request。然后页面会自动跳转到你新建的拉取请求

  9. 等待大约20秒，然后刷新页面。GitHub Actions 将自动更新到下一步。

步骤4：合并拉取请求

做得很好！😎

您已成功创建拉取请求。 您现在可以合并您的拉取请求。

什么是合并(merge)?： 此操作将拉取请求中的修改合并到main分支中。有关合并的更多信息，请参阅"Merging a pull request"。

As noted in the previous step, you may have seen evidence of GitHub Actions running which automatically progresses your instructions to the next step. You'll have to wait for it to finish before you can merge your pull request. It will be ready when the merge pull request button is green.

screenshot of green merge pull request button

⌨️ 练习：合并拉取请求

  1. 点击 Merge pull request

  2. 点击 Confirm merge

  3. 一旦您的分支被合并，您就不再需要它了。 要删除此分支，请单击“删除分支”

    screenshot showing delete branch button

  4. 等待大约20秒，然后刷新页面。GitHub Actions 将自动更新到下一步（完成）。

完成

恭喜您完成了本课程！

课程回顾：

  1. 您学习了关于什么是 GitHub、仓库、分支、提交和拉取请求
  2. 您创建了一个分支、一个提交和一个拉取请求
  3. 你学会了合并拉取请求
  4. 你做出了第一个贡献！ 🎉