一、GitHub是什么?
GitHub是为开发者提供 Git仓库的托管服务。这是一个让开发者与 朋友、同事、同学及陌生人共享代码的完美场所。GitHub除提供 Git仓库的托管服务外,还为开发者或团队提供了一 系列功能,帮助其高效率、高品质地进行代码编写。
GitHub 与 Git 的区别
在此讲解一下 GitHub 与 Git的区别。GitHub 与 Git 是完 全不同的两个东西。 在 Git 中,开发者将源代码存入名叫“Git 仓库”的资料库中 并加以使用。而 GitHub 则是在网络上提供 Git 仓库的一项服务。 也就是说,GitHub上公开的软件源代码全都由Git进行管 理。理解 Git,是熟练运用 GitHub 的关键所在。
此前,用于辅助多人协同工作的软件层出不穷,然而它们中的大部 分又一个个退出了历史的舞台。在这类软件中,群件(Groupware)和 CRM(Customer Relationship Management,顾客关系管理)等脱颖而出, 被全世界的商业人士所用。但是,在以程序员为代表的软件开发者之间,一直都没有一个用来 辅助多人协同编程的关键性软件。因此软件开发者们往往要将版本管理系统、BUG跟踪系统、代码审查工具、邮件列表、IRC等众多工具组合 在一起,以实现多人协作。 开发者们已对这种软件开发协作模式司空见惯,然而GitHub的出 现为其带来了巨大变化。
Pull Request
Pull Request是指开发者在本地对源代码进行更改后,向 GitHub中 托管的Git仓库请求合并的功能。开发者可以在Pull Request上通过评 论交流,例如“修正了BUG,可以合并一下吗?”以及“我试着做了这 样一个新功能,可以合并一下吗?”等。通过这个功能,开发者可以轻 松更改源代码,并公开更改的细节,然后向仓库提交合并请求。而且,如果请求的更改与项目的初衷相违,也可以选择拒绝合并。GitHub的 Pull Request不但能轻松查看源代码的前后差别,还可以 对指定的一行代码进行评论。通过这一功能,开发者们可以针 对具体的代码进行讨论,使代码审查的工作变得前所未有地惬意。方便和快捷并不是 Pull Request的专利。任务管理和 BUG报告可以 通过Issue进行交互。如果想让特定用户来看,只要用“@ 用户名”的 格式书写,对方便会接到通知(Notifications),查看 Issue。由 于也提供了Wiki功能,开发者可以轻松创建文档,进行公开、共享。 Wiki更新的历史记录也在 Git 中管理,可以让用户轻松更改。
在 GitHub上,用户所有用文字输入的功能都可以用GitHub Flavored Markdown(GFM)语法进行描述。这个语法可以让标记变得简 单,以此写出的评论与文档也会更容易理解。只记住一个语法便能在多 种交流中使用,何乐而不为呢 ?它还有一个很特别的功能,那就是可 以在评论中添加文字表情,使用户间的交流更加顺利。 随着GitHub的普及,正在有越来越多的服务开始兼容Markdown 语法。 GitHub 中可使用的描述方法并不止“@ 用户名”一种。 输入“@ 组织名”可以让属于该 Organization(组织)的所 有成员收到通知注a。输入“@ 组织名 / 团队”可以让该团队的所 有成员收到通知。这就是同时向多人发送通知的方法。 输入“# 编号”,会连接到该仓库所对应的 Issue 编号。输入 “用户名 / 仓库名 # 编号”则可以连接到指定仓库所对应的 Issue 编号。只要按照这类特定格式书写便会自动创建链接。 多加利用上述这些功能,可以让交流更有效率。
GitHub 提供的主要功能
在 GitHub上,有许多帮助开发者高效输出优质代码的功能。这里, 我们就简单地为您说明这些功能。
● Git 仓库
一般情况下,我们可以免费建立任意个 GitHub提供的 Git仓库。但 如果需要建立只对特定人物或只对自己公开的私有仓库,则需要依照套 餐类型 B 支付每月最低 7 美元的使用费。
● Organization
通常来说,个人使用时只要使用个人账户就足够了,但如果是公 司,建议使用Organization账户。它的优点在于可以统一管理账户和权 限,还能统一支付一些费用。 如果只使用公开仓库,是可以免费创建 Organization账户的。因此, 如果是以交流群或IT小团体的形式进行软件开发时不妨试一试。
● Issue
Issue功能,是将一个任务或问题分配给一个 Issue进行追踪和管理 的功能。可以像 BUG 管理系统或 TiDD(Ticket-driven Development)的 Ticket一样使用。在 GitHub上,每当进行我们即将讲解的 Pull Request, 都会同时创建一个 Issue。 每一个功能更改或修正都对应一个Issue,讨论或修正都以这个 Issue为中心进行。只要查看Issue,就能知道和这个更改相关的一切信 息,并以此进行管理。 在 Git的提交信息中写上 Issue的 ID(例如“#7”), GitHub就会自 动生成从Issue到对应提交的链接。另外,只要按照特定的格式描述提 交信息,还可以关闭Issue。这是一个非常方便的功能,请务必实践一 下。详细内容将在第 5 章中为您讲解。
● Wiki
通过Wiki功能,任何人都能随时对一篇文章进行更改并保存,因 此可以多人共同完成一篇文章。该功能常用在开发文档或手册的编写 中。语法方面,可以通过第 5 章讲解的 GFM 语法进行书写。 Wiki页也是作为Git仓库进行管理的,改版的历史记录会被切实保 存下来,使用者可以放心改写。由于其支持克隆至本地进行编辑,所以 程序员使用时可以不必开启浏览器。
● Pull Request
开发者向GitHub的仓库推送更改或功能添加后,可以通过Pull Request 功能向别人的仓库提出申请,请求对方合并。 Pull Request送出后,目标仓库的管理者等人将能够查看Pull Request 的内容及其中包含的代码更改。 同时,GitHub还提供了对 Pull Request和源代码前后差别进行讨论 的功能。通过此功能,可以以行为单位对源代码添加评论,让程序员之间高效地交流。