IBM全栈开发【12】：Git和GitHub入门

近期在学习IBM全栈应用开发微学士课程，故此记录学习笔记。

唉，本来还剩一个证就考完了，结果原先十二个证的微学士学位路线被标过期，最新的路线新添了这个 Git 和 GitHub 入门的证，100 美元喜减一。

1. Git 和 GitHub 基础知识

应用程序开发人员很少单独工作。大型网络/云/移动开发和数据科学项目将包括许多人——前端开发员、后端开发员、数据库管理员、存储库管理员等。必须跟踪和控制每个贡献者的每次更改，以实现协作、问责制和版本管理。这种分布式版本控制在管理小型和大型软件项目时都极为重要。

在本模块中，你将了解一些流行的版本控制工具，创建一个 GitHub 账户，并使用 GitHub 网页界面创建一个仓库，向其中添加文件并提交更改。在 GitHub 等基于 Git 的版本控制系统中，分支是工作流程的核心。您还将熟悉创建和使用分支，并将更改合并到主分支。

学习目标：

• 定义分布式版本控制。
• 列出用于版本控制的几种工具，包括流行的 Git 平台。
• 描述 Git 的基本概念和仓库的目的。
• 在你的仓库中添加/编辑文件，并使用 GitHub 网页界面提交修改。
• 创建 GitHub 账户和仓库。
• 解释如何使用分支并描述拉取请求。
• 使用 GitHub Web 界面创建 GitHub 分支并执行合并操作。

1.1. Git 和 GitHub 概述

Git 和 GitHub 是深受开发人员和数据科学家欢迎的环境，但如果不了解版本控制的基本知识，就无法讨论它们。

版本控制系统可让您跟踪对源代码的更改。这样，如果您犯了错误，就可以很容易地恢复旧版本的文档。此外，它还能让与其他团队成员的协作变得更加容易。

用一个例子来说明版本控制是如何工作的：假设你有一份购物清单，希望室友们确认你需要的东西并添加其他物品。如果没有版本控制，在去购物之前就会有一大堆乱七八糟的东西要收拾，而有了版本控制，在每个人都献计献策之后，你就能清楚地知道自己需要什么。

Git 是根据通用公共许可证或 GNU 发布的免费开源软件。它是一种分布式版本控制系统（或称 DVCS），这意味着世界上任何地方的用户都可以在自己的电脑上拥有项目的副本。当他们进行修改时，他们可以将自己的版本同步到远程服务器，与你共享。

Git 并不是唯一的版本控制系统，但它的分布式特性是其成为最流行版本控制系统的主要原因之一。版本控制系统广泛应用于涉及代码的事务，但你也可以对图像、文档和任何文件类型进行版本控制。请注意，Git 还支持分支策略，如功能分支，以组织和管理开发工作。

GitHub 是最受欢迎的 Git 仓库网络托管服务之一。其他服务包括 Git Lab、Bitbucket 和 Beanstock。

在开始之前，你需要了解一些基本术语：

• Secure Shell 或简称 SSH 协议是一种从一台计算机安全远程登录到另一台计算机的方法。
• Fork 是一个仓库的副本。
• 拉取请求（Pull Request 或简称 PR）是指你请求他人在你的修改成为最终版本之前对其进行审核和批准。
• 工作目录（Working Directory）包含计算机上与 Git 仓库相关联的文件和子目录。
• 提交（Commit）是项目当前状态在某个特定时间点的快照，并附有所做改动的说明。
• 分支（Branch）是一条独立的开发线，可以让你独立完成功能或修正。
• 合并（Merge）是将一个分支中的改动合并到另一个分支中，通常是将特性分支合并到主分支中。
• 克隆（Clone）会在你的电脑上创建一个远程 Git 仓库的本地副本。

1.1.1. GitHub 入门

2000 年代初，Linux 的开发由一个名为 BitKeeper 的免费系统管理。2005 年，BitKeeper 转为收费系统，出于多种原因，这给 Linux 开发人员带来了麻烦。Linus Torvalds 带领团队开发了一个替代的源代码版本控制系统。该项目在很短的时间内完成，主要特点由一个小组确定。其中包括：

• 对非线性开发的强大支持。(当时，Linux 补丁以每秒 6.7 个的速度到达）
• 分布式开发。每个开发人员都可以拥有一份完整开发历史的本地副本。
• 与现有系统和协议兼容。这是承认 Linux 社区多样性的必要条件。
• 高效处理大型项目。
• 历史加密验证。这确保分布式系统的代码更新完全一致。
• 可插拔的合并策略。许多开发途径都可能导致复杂的整合决策，可能需要明确的整合战略。

Git 仓库模型有什么特别之处？Git 是一个分布式版本控制系统。主要用于在开发过程中跟踪源代码。它包含在程序员之间进行协调、跟踪更改和支持非线性工作流程的元素。由 Linus Torvalds 于 2005 年创建，用于发布 Linux 内核。

Git 是一个分布式版本控制系统，用于跟踪内容变更。它是协作的中心点，尤其侧重于敏捷开发方法。在中央版本控制系统中，每个开发人员都需要从中央系统中签出代码并提交到中央系统中。由于 Git 是一种分布式版本控制系统，每个开发人员都有一份完整开发历史的本地副本，而且变更会从一个仓库复制到另一个仓库。每个开发人员都可以充当中枢。如果正确使用 Git，就会有一个与可部署代码相对应的主分支。团队可以持续整合已准备好发布的变更，并在两次发布之间同时在不同的分支上工作。

Git 还允许对任务进行集中管理，并对每个团队进行访问级别控制。Git 可通过 GitHub 桌面客户端等方式在本地使用，也可直接通过连接到 GitHub 网页界面的浏览器使用。IBM 云基于完善和成熟的开源工具，包括 Git 仓库（通常称为 repos）。

GitHub 是 Git 仓库的在线托管服务。GitHub 由微软的一家子公司托管。GitHub 提供免费、专业和企业账户。截至 2019 年 8 月，GitHub 拥有超过 1 亿个仓库。

仓库是用于存储文件（包括应用程序源代码）的数据结构。仓库可以跟踪和维护版本控制。

GitLab 是一个完整的 DevOps 平台，以单个应用程序的形式交付。GitLab 可访问由源代码管理控制的 Git 代码库。通过 GitLab，开发人员可以协作、审查代码、发表评论并帮助改进彼此的代码。使用自己的本地代码副本工作。在需要时对代码进行分支和合并。利用内置的持续集成（Cl）和持续交付（CD）简化测试和交付。

1.1.2. GitHub 分支

本课内有关注册 GitHub 账户和创建 GitHub 仓库的内容被我跳过了，建议去网上搜索相关的教程。

GitHub 中的所有文件都存储在一个分支中。主分支是确定的，它存储的是代码的可部署版本。主分支是默认创建的，但你也可以使用任何分支作为代码的主要、完成和可部署版本。当你计划更改内容时，可以创建一个新的分支，并给它起一个描述性的名字。新分支一开始就是原始分支的完全副本。当你进行更改时，你创建的分支会保留更改后的代码。

要创建新分支，请单击下拉菜单 Main，在新分支文本中添加新分支名称，然后选择 Create Branch。

对于大型软件项目来说，GitHub 分支可能非常复杂。对于我们正在探索的这种简单项目，可以考虑以下方法：从一个共同的基础开始，也就是这个项目的初始源。在开发新功能时，代码会被分支。

举个例子，两个分支都在进行修改。当两个工作流准备好合并时，每个分支的代码都会被识别为一个提示（tip），然后将两个提示合并为第三个合并分支。

开发人员在分支中处理源文件。由于有些项目需要一段时间，源文件并不能立即发挥作用。要更改文件内容，需要选择文件，点击铅笔图标，进行更改，然后提交更改。当开发人员完成指定的工作后，为了保存他们的修改，他们会提交代码。提交表示开发人员确信代码代表了正在开发的功能或功能集的稳定平台。

当开发人员将变更源提交到自己的路径时，他们需要写一个注释来描述变更。注释应具有意义和描述性。开发人员可以选择提交到当前分支或创建一个新分支。最后，点击 Commit Changes。

写注释时的一些最佳做法：不要用句号结束评论信息；提交信息的字符数不要超过 50 个；使用扩展窗口了解详情；始终使用主动语态。

拉取用于启动分支合并，以捕捉变更。拉取请求会将提交的修改建议提供给其他人审查和使用。即使代码尚未完成，也可以在任何提交后进行拉取。拉取需要用户批准更改。该用户可以是变更的作者，也可以是团队中的指定人员。

请注意，如果你在不属于你的分支上做了改动，GitHub 会自动以你的名义提出拉取请求。由于日志文件不可更改，因此总能找到批准合并变更的人。

要打开拉取请求，请单击 Pull Requests 并选择 New Pull Request：

1. 从比较框中选择新分支。
2. 向下滚动查看变更。
3. 确认这些更改就是你要评估的内容。
4. 为请求添加标题和描述。
5. 点击 Create Pull Request。

Git 仓库的目的是让主分支成为唯一部署的代码。开发人员可以修改分支中的源文件，但只有提交后才会发布。拉取命令发出后，代码会被审核和批准。审核通过的代码会被合并回主代码。

要将已提交的代码变更合并到主代码中，请单击 Merge Pull Request，然后单击 Confirm Merge。当某个分支的所有变更完成后，该分支将被视为过时，应予以删除。

2. 分支、Git 命令和管理 GitHub 项目

当你开始使用 GitHub 仓库并自动化工作流程时，使用网页界面可能会受到限制，而且更耗时。这就是 Git 命令的用武之地。你可以在自己的桌面或云 IDE 提供的虚拟桌面上使用它，无论你在哪里开发代码。

在本模块中，你将熟悉并使用各种 Git 命令来克隆和分叉仓库，以及使用命令行提交、推送和拉取更改。

2.1. Git 工作流概览

想象一下，你加入了一个为电子商务平台开发功能的团队。你的任务是添加产品推荐功能。团队使用 Git 和 GitHub 进行版本控制和协作。您将如何与使用 Git 和 GitHub 的团队有效协作？清楚地了解 Git 工作流程能确保您有效地使用 Git 进行版本控制和协作。这些知识将帮助你避免代码冲突和无意中覆盖团队成员工作等问题。

第一步是克隆团队在 GitHub 上托管的仓库。克隆会在本地计算机上创建一个项目代码副本，以及远程仓库的完整版本历史。通过克隆过程中建立的连接，你可以向远程仓库推送代码变更。你也可以将远程仓库中的任何更改提取到本地仓库中并进行更新。

作为开发人员，您可能会尝试多种方法来编写该功能的代码。在代码准备就绪之前，您可能不想让更改影响主分支。好的做法是从主分支创建一个分支，然后在新创建的分支上工作。在 Git 中，分支是一个基于主分支的独立开发空间，您可以在其中进行修改。在这种情况下，添加功能时不能干扰主代码库。

开发完功能后，下一步就是选择修改过的文件并将它们移到暂存区（Staging area）。暂存区是一个临时存储空间，在要求 Git 将所选文件保存到本地仓库之前，您可以在这里收集这些文件。现在您可以将文件提交到新创建的分支。提交文件可以记录更改，确保新功能成为分支的一部分。当你提交文件时，包含提交信息可为你和团队成员提供上下文，以便他们理解变更。例如，在提交信息中加入“已实现产品推荐功能”。

下一步是将分支中的变更推送到远程仓库。通常情况下，代码在合并到远程仓库的主分支之前，会由负责管理仓库的维护者进行审核。要合并分支，需要创建拉取请求。这是向维护者提出的请求，请其审查并批准分支中的更改。维护者合并拉取请求后，分支中的更改就会反映在主分支中。同样，如果你有维护者权限，就会收到团队成员的拉取请求，你将审查并批准他们的请求。

您已经了解了软件开发项目的典型工作流程。在某些情况下，你可能会从头开始一个项目，并打算与他人合作。你可以将本地项目目录初始化为 Git 仓库，这样 Git 就会开始跟踪项目目录中的改动。下一步是选择所有需要 Git 跟踪的项目文件，将它们移到暂存区，然后进行初始提交。接着创建一个空白仓库，并将本地 Git 仓库链接到远程仓库。再之后，你会把本地仓库中的所有项目文件推送到远程仓库。其他开发人员可以克隆远程仓库，并按照常规工作流程更新项目文件。

让我们通过一个用例来更好地理解工作流程。某公司为一个新的网络应用程序开发项目指派了一个由开发人员、测试人员和产品经理组成的团队。首席开发员 Anne 在自己的工作目录中初始化了一个 Git 仓库。她创建项目文件，将其移动到暂存区域，然后进行初始提交。然后，她将提交推送到自己创建的空白远程仓库。所有开发人员都克隆了远程仓库，并通过创建分支开始工作。

其中一名开发人员 John 负责实现用户身份验证功能。他从主分支中创建了一个名为 User Auth 的新分支。经过全面测试后，他将分支推送到远程仓库，并创建了一个拉取请求。Anne 审核并批准了拉取请求，将修改合并到主分支中，这样其他开发人员就可以访问 John 所做的修改。同样，其他开发人员也会向远程仓库推送他们所做功能的提交。至此，功能开发完成，项目准备发布。

Anne 从远程仓库中的主分支创建了一个名为 Release 1.0 的发布分支。团队从远程仓库中提取变更，以便更新本地仓库。他们在 Release 1.0 分支中执行最终测试、错误修复和文档更新。测试完成后，他们提交更改，将提交推送到远程仓库，并创建拉取请求。Anne 审核并将更改合并到主分支中，然后将发布标记为 Release 1.0。

2.2. Git 命令概述

Git 命令有多种用途，例如跟踪和保存更改，以及与他人共享更改。通常情况下，许多此类活动都是通过网页界面执行的。命令行界面（或 CLI）是执行这些活动的另一种选择。

让我们来学习一些基本命令，如：

• git init
• git add
• git status
• git commit
• git reset
• git log
• git branch
• git checkout
• git merge

git init 命令会在一个目录中初始化一个新的 Git 仓库，这是为项目设置版本控制的第一步。要创建一个 Git 仓库，可以在命令提示符下导航到所需的目录。然后运行 git init 命令。该命令将创建一个名为 .git 的隐藏子目录。

第二个命令是 git status 命令。通过 git status，您可以查看工作目录的状态以及您所做修改的暂存快照。它提供的信息包括哪些文件已被修改，以及这些文件是否为下一次提交而暂存。为此，您可以导航到 git 仓库所在的目录，然后在命令提示符下运行 git status 命令。这将显示有关当前仓库状态的信息。

第三种是 git add . 命令，它可以将工作目录中的改动移动到暂存区域。例如，您的 Git 仓库中有一个名为 index.html 的文件，您在其中做了一些改动。这些改动将包含在下一次提交中。为此，你可以打开命令提示符并导航到有 index-html 文件的 Git 仓库。运行 git add . 命令。这样，当前目录中的所有改动都会在下一次提交时加入。

第四个是 git commit 命令。git commit 会将您所做修改的阶段快照保存到项目中，并附带说明性信息。这条信息解释了提交的目的。假设您想在仓库中创建一个新的 HTML 文件。您可以使用 git commit -m "commit message" 命令来提供描述性信息，比如 git commit -m "created a new HTML file"。

至此，你已经了解了 git init、git add、git status 和 git commit 命令。

现在，第五个命令是 git log 命令，它能让你浏览项目以前的改动。如果想查看提交历史，可以定位到 Git 仓库所在的目录，然后运行 git log 命令。这将提供每次提交的相关信息。例如，创建一个新的 HTML 文件就会反映在提交历史中。

下一个命令是 git reset。git reset 命令会撤销您对工作目录中文件所做的更改。因此，如果代码出错，可以运行 git reset 命令。通过使用 git reset soft 命令，您将重新添加已暂存的更改，并准备好再次提交。

第七个命令是 git branch 命令。它可以列出、创建、重命名甚至删除 Git 仓库中的分支。例如，如果想在项目中创建一个名为 code list 的新分支，可以使用 git branch 命令，后面跟上新分支的名称，在本例中就是 code_list。

第八个命令是 git checkout 命令。git checkout 命令可以让你在现有分支之间切换。因此，如果你想切换到 Git 仓库中名为 code_list 的分支，可以运行 git checkout 命令，后面跟上该分支的名称，即 code_list。这条命令会从仓库中签出一个分支到工作目录中。

第九条也是最后一条命令是 git merge。git merge 可以让你把所有东西重新组合在一起，并将特性分支与主分支合并。因此，如果您在代码列表分支上实现了一个新功能，您就会想把它合并回主分支。您可以使用 git checkout 命令进入目标分支，然后使用 git merge 命令，后面跟上分支名称，在本例中就是 code_list。该命令允许 Git 将特性分支的所有变更集应用到主分支的顶端。

2.2.1. 更多的命令

• git pull：它能从远程仓库获取变更，并将其合并到本地分支。首先，运行 git checkout 命令切换到要合并的分支。然后，运行 git pull 命令，它会从远程仓库的主分支获取改动，并将其合并到你的当前分支。
• git push：它能将本地仓库内容上传到远程仓库。首先运行 git checkout 命令，确保您所在的是要推送的分支，然后再将该分支推送到远程仓库。
• git version：它显示系统上安装的当前 Git 版本。
• git diff：它能显示提交之间的变化、提交树和工作树等。它还能比较分支。
• git revert：它通过应用新提交来恢复提交。这会创建一个新的提交，撤销上次提交所做的更改。
• git config -global user.email <Your GitHub Email>：它为 Git 设置全局电子邮件配置。需要在提交前执行，以验证用户的电子邮件 ID。
• git config –global user.name <Your GitHub Username>：它为 Git 设置全局用户名配置。需要在提交前执行，以验证用户的用户名。
• git remote：它列出了与本地仓库相关联的所有远程仓库的名称。
  • git remote -v：它列出了本地 Git 仓库所连接的所有远程仓库，以及与这些远程仓库相关的 URL。
• git remote add origin <URL>：它使用指定的 URL 添加一个名为 origin 的远程仓库。
• git remote rename：在 git remote rename 命令后面跟上要重命名的远程仓库名称（在这个例子中，origin）和新名称（例如：upstream）。这将把 origin 远程仓库重命名为 upstream。
• git remote rm <name>：它会删除指定名称的远程仓库。
• git format-patch：它可生成用于通过电子邮件提交的补丁。这些补丁可用于通过电子邮件提交更改或与他人共享。
• git request-pull：它能为电子邮件请求生成待处理更改摘要。它有助于将分支或分叉中的更改传达给上游仓库维护者。
• git send-email：它能以电子邮件的形式发送补丁集合。它允许你通过电子邮件向收件人发送多个补丁文件。请确保使用 git config 命令设置电子邮件地址和名称，以便电子邮件客户端在发送邮件时知道发件人的信息。
• git am：它将补丁应用到仓库。它将补丁文件作为输入，并将补丁文件中指定的更改应用到仓库。
• git daemon：它通过 Git:// 协议公开软件仓库。Git 协议是一种轻量级协议，旨在实现 Git 客户端和服务器之间的高效通信。
• git instaweb：它能立即启动网络服务器来浏览资源库。它提供了一种简化的方式，无需配置完整的网络服务器，即可通过网络界面查看资源库内容。
• git rerere：它会重复使用之前已解决的合并冲突的解决记录。请注意，需要将 rerere.enabled 配置选项设为 true（git config -global rerere.enabled true），git rerere 才能工作。此外，请注意 git rerere 只适用于使用同一分支和提交解决的冲突。

3. 最终项目

现在，你已经熟悉了 GitHub 仓库、分支和 Git 命令，在本模块中，你将运用所学知识和技能创建一个 GitHub 项目，添加一些文件（如开源许可证），并将其公开共享。

3.1. 概述和评分标准

现在您已经掌握了使用 GitHub UI 和 Git CLI 的知识和技能，您将利用这些技能在 Git 上创建一个开源项目，对该项目进行修改并将其提供给社区。您将分叉一个 GitHub 仓库，克隆该仓库到本地系统，更改本地仓库，在本地提交更改，推送回 GitHub 分叉仓库，并创建一个拉取请求，将您的更新添加到原始仓库。这个期末作业项目分为两个部分。

1. GitHub UI

   你最近受聘成为一家小额信贷初创公司的开发人员，该公司的使命是为低收入人群赋权并提供机会。核心团队目前使用 Subversion (SVN) 管理代码。他们希望慢慢将代码转移到 Git。作为第一步，他们要求您在 GitHub 上的一个新仓库中托管计算单利的示例代码。您不仅要托管脚本，还要遵循本课程介绍的最佳实践，为开源项目创建支持文档，包括行为准则和贡献指南。此外，该资源库应根据 Apache License 2.0 向社区开放。

2. Git CLI

   恭喜您与贵公司一起在 GitHub 上创建了一个开源的简单利息计算器 bash 脚本。您的更改已被接受和合并，公司已创建了一个新的全球资源库，供团队协作使用。随着时间的推移，其他开发人员也为该仓库做出了贡献。您的团队在其中一个标记文件中发现了一个错误。我们要求您 fork 这个仓库，在提供的实验室环境中使用 Git CLI 修正错误，并打开一个拉取请求。

3.2. 第 1 部分 - GitHub UI

完成本实验后，你将证明自己可以：

• 在 GitHub 账户中创建一个新仓库。
• 为项目选择合适的许可证。
• 创建一个 README.md 文件，解释项目的目的。
• 创建 Code of Conduct Markdown 文件，说明你希望社区成员如何行为和互动。
• 创建 Contribution Guidelines Markdown 文件，告诉社区如何贡献。
• 将新文件提交到仓库。

注意：在整个实验过程中，系统会提示你将 URL 复制并粘贴到编辑器中，然后保存到自己的设备上。这些 URL 将在课程的 Final Submission 部分上传供同行评审。您可以使用任何编辑器应用程序来记录您的 URL。

3.2.1. 创建 GitHub 仓库

创建一个名为 github-final-project 的新 GitHub 仓库，并确保它是公开的。

选择 Add a README file 和 Choose a license 复选框。从下拉菜单中选择 Apache 2.0 License。

点击 Create Repository。您的仓库就创建完成了，其中包括 README 和 LICENSE 文件。现在，您可以更新仓库文件，为社区提供有用的信息。

将仓库的 URL 保存在记事本中，稍后提交给同行评审。

3.2.2. 更新 README 文件

在文件中添加以下信息：

A calculator that calculates simple interest given principal, annual rate of interest and time period in years.

Input:
  p, principal amount
  t, time period in years
  r, annual rate of interest
Output
  simple interest = p*t*r

可选：您可以在开发项目的过程中继续更新 README 文件。您可以从以下资源中找到一些有用的 README 内容：

• GitHub README
• Make a README
• Awesome README

3.2.3. 添加行为准则

行为准则有助于为项目参与者的行为制定基本规则。它定义了如何参与社区活动的标准。

GitHub 提供了常用的行为准则模板，可帮助您快速为项目添加行为准则。要在项目中添加行为准则，请完成以下步骤：

1. 在仓库根目录下添加一个名为 CODE_OF_CONDUCT.md、模板为 Contributor Covenant 的新文件。
2. 访问仓库主页，检查文件是否已创建。

输入 CODE_OF_CONDUCT 后就会自动出现选择模板的选择。

3.2.4. 增加贡献指南

贡献指南告诉项目参与者如何为项目做出贡献。要添加贡献指南，请完成以下步骤：

1. 在仓库根目录下创建一个名为 CONTRIBUTING.md 的新文件，其中包含以下信息：

   All contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome.

2. 将文件提交到主分支，并检查它是否列在仓库的主页上。

您也可以选择查看以下指南，了解贡献指南的示例并更新此文件：

• Contributing to Legit Info, a Call for Code for Racial Justice Project
• Contributing to OpenEEW
• Contributing to Atom
• How to contribute to Ruby on Rails

3.2.5. 托管脚本文件

1. 在仓库根目录下新建一个名为 simple-interest.sh 的文件。
2. 在新文件中添加以下代码：

   #!/bin/bash
   # This script calculates simple interest given principal,
   # annual rate of interest and time period in years.
   
   # Do not use this in production. Sample purpose only.
   
   # Author: Upkar Lidder (IBM)
   # Additional Authors:
   # <your GitHub username>
   
   # Input:
   # p, principal amount
   # t, time period in years
   # r, annual rate of interest
   
   # Output:
   # simple interest = p*t*r
   
   echo "Enter the principal:"
   read p
   echo "Enter rate of interest per year:"
   read r
   echo "Enter time period in years:"
   read t
   
   s=`expr $p \* $t \* $r / 100`
   echo "The simple interest is: "
   echo $s

3. 将文件提交到主分支。

3.3. 第 2 部分 - Git CLI

完成本实验后，您将能够证明自己可以：

• 将上游仓库 fork 到自己的账户。
• 本地克隆代码。
• 在仓库中创建一个分支。
• 在分支中进行修改并提交。
• 将分支合并回主分支。
• 从分叉仓库向上游仓库创建拉取请求。
• 还原之前所做的更改。

3.3.1. Fork 仓库

Fork 项目的源代码库。

3.3.2. 修正错字并与 master 合并

我自己在本地环境使用 Git Bash，分支并非教程中写的 main 而是 master，因此下面的内容都会以 master 分支为主。

1. 克隆自己 Fork 的仓库。

   git clone https://github.com/<Your name>/jbbmo-Introduction-to-Git-and-GitHub.git

2. 创建一个名为 bug-fix-typo 的分支。

   git checkout -b bug-fix-typo

3. 将 README.md 中的页脚从

   2022 XYZ, Inc.

   改为

   2023 XYZ, Inc.

4. 添加修正后的文件并提交，同时写上有意义的信息。

   git add README.md
   git commit -m "Updated the footer year in README.md"

5. 将修复推送到 bug-fix-typo 分支。

   git push origin bug-fix-typo

6. 切换到 master 分支。将 bug-fix-typo 分支合并回 master 分支。

   git checkout master
   git merge bug-fix-typo

3.3.3. 还原错字并提交拉取请求

1. 检查 master 分支中 README.md 的内容。该文件现在应为：

   2023 XYZ, Inc.

   可以在 Git Bash 中使用 cat <filename> 命令来直接查看。

2. 创建一个名为 bug-fix-revert 的新分支。

3. 使用 git revert 命令还原上一个任务中的更改。

   git log
   git revert <commit-hash>

   首先，您需要找到要恢复的变更的提交哈希值。这可以通过 git log 查看提交历史来实现。有了提交哈希值，就可以用 git revert <commit-hash> 来还原了。记得将 <commit-hash> 替换为实际的提交哈希值。

   现在文件应为：

   2022 XYZ, Inc.

4. 将还原推送到你的仓库中的 bug-fix-revert 分支。

5. 转到 GitHub UI。从你的仓库的 bug-fix-revert 分支向原始仓库的主分支创建一个新的拉取请求。此 PR 将自动关闭。

3.3.4. 检查分支状态

导航至页面上 GitHub UI 中的 Branches 部分。它的格式如下：

https://github.com/<Your Github username>/jbbmo-Introduction-to-Git-and-GitHub/branches

在这一部分中，您可以找到分支名称及其当前状态。