GitHub使用笔记一

你的名字 2022-05-18 07:48 188阅读 0赞

## Git 简介 ##

Git是一个版本控制系统。版本控制系统是设计用于跟踪文件随时间变化状态的一款软件。更具体地说,Git是一个分布式的版本控制系统。这就意味着,在Git中参与项目的每个程序员不仅能拥有文件的当前状态,还能拥有项目完整的历史记录。

## GitHub 简介 ##

Github是一个网站,你可以向该网站上传一个Git数据库副本。使用 Github使你与他人合作一个项目变得更容易,而这归功于 Github提供的下述机制:一个用以共享库的集中位置,一个基于Web的界面以及分又(forking)、拉请求(pull request)、提出问题(issue)、维基(WiKi)等功能,这些功能使你和你的团队能更有效地对所做的修改进行说明、讨论和评估。

## 关键概念 ##

***提交 (commit)***

无论何时你将一个或多个文件修改保存到Git的历史记录,你都会创建一个新的提交。示例用法:“让我们提交这些更改并发送到 Github。

***提交消息(commit message)***

每次做出提交时,你需要提供一个消息,描述为什么要进行这种改动。当以后试图理解为什么实现特定的修改时,提交的这一消息是非常有用的。示例用法:“在提交消息时一定要包括苏珊关于SEC新准则的评论。”

***分支(branch)***

就是存放在一侧的独立的系列提交,你可以使用它来进行一个实验或者创建个新的功能。示例用法:“让我们创建一个分支来实现新的搜索功能。”

***主分支(master branch)***

无论什么时候创建一个新的Git项目,都会创建一个默认的分支,称为主分支。这个分支一旦准备发布,你的工作则应完全停止。示例用法:“记住不要直接提交给主分支。”

***功能分支(feature branch)***

不论何时构建一个新的功能,都将创建一个分支,称为功能分支。示例用法:“我们已有太多的功能分支,让我们集中解决其中一两个并完成部署。”

***发布分支(release branch)***

如果你有一个手动QA(质量管理)流程,或者为满足客户需求而必须支持日版本的软件时,你需要一个发布分支以存放必要的补丁或更新记录。功能分支跟发布分支没有任何技术差别,但是在和团队谈论项目时,区别两者是有用的。示例用法:“我们必须解决所有支持的发布分支下的安全漏洞。”

***合并(merge)***

合并是将一个分支完成的全部工作归并到另一个分支。通常情况下是将一个功能分支合并到主分支。示例用法:“有关‘我的帐户’功能的伟大工作。你能将其合并到主分支吗？这样我们可以将其发布。”

***标签(tag)***

引用一个特定历史的提交。最常用于记录发布版本,据此你可以知道发布的是哪个版本的代码以及何时生成的。示例用法:“让我们标记这个版本,并使其发布吧。”

***査看(check out)***

找到一个不同版本的项目历史记录,以及时査看该时间点的文件。通常你会找个分支以查看在其上完成的所有工作。但其实你可以査看任何类型的提交。示例用法:“你可以査看最后发布的版本标签吗?发布时有一个错误,需要你复制和修复。”

***拉请求(pull request)***

最初,拉请求是用来请求别人复査已经完成的分支工作,并将它合并到主分支。现在,拉请求常用在一个流程的早期阶段,用以讨论可能的功能。示例用法:“为新的投票功能去创建一个拉请求,这样我们可以看到团队其他人是如何考虑的。”

***提出问题(issue)***

Github有一个称为提出问题的功能,可以用来讨论功能、跟踪缺陷,或两者兼备。示例用法:“你是对的,在手机上这个登录行不通。你可以在 Github上创建一个issue,记录复制这个错误的步骤吗?”

***维基(WiKi)***

维基最初由Ward Cunningham开发,是一个轻量级的Web页面创建方式,创建的Web页面之间用简单的链接相联系。Git Hub项目经常使用WiKi进行文档记录。示例用法:“你能在WiKi中添加一个页面,解释如何配置运行在多个服务器上的项目吗?”

***克隆(clone)***

通常你要从Github下载一个项目的副本,这样你就可以在本地工作。将项目库复制到你的电脑的过程称为克隆。示例用法:“你能克隆存储库,修复错误,然后今晚把修复发送回 Github吗?”

***分叉(fork)***

有时候你不具备直接改变一个项目的必要的许可。也许这是一个你不知道的人写的开源代码,或者是你公司另一团队写的项目,而你不曾过多参与其中。如果你想对这样的一个项目提交修改,首先需要在Github上你的用户帐户下复制这个项目。这一过程被称为分叉存储库。然后你可以克隆、修改,并使用拉请求将其提交回最初的项目。示例用法:“我想看看你将如何重写主页的营销文案。请分叉项目并提交一个拉请求,提出你的修改。”

## 项目页面介绍 ##

![70][]

左上角是项目名称 "bootstrap"，拥有者是 "twbs"，点击 "twbs" 可以看到该组织所有的项目清单，左侧的图标显示这是一个公共库，所有人都可以查看，右侧可以看到，截图时刻有7374个人在关注此库，有更新时可以得到通知，有126419人将其标上星号，表示这是他们最喜欢的项目之一，有61258人曾经分叉这一库文件，在GitHub上制作自己的副本并通过GItHub上传修改与他人分享。

继续往下看，有一个简短的描述，在其下方将看到项目已经有17837次提交(变化)，目前正在分支(开发)的不同历史数据流有36个，已经有49个版本发布给人们使用，并且有1018人编写了代码的某些部分。

还可以看到我们当前正在v4-dev分支下，最近一次提交到该分支的操作是 "mdo Merge branch 'form-validation-icons' into v4-dev"

***查看提交历史***

用来 了解最新小工作单元

单击 "17, 837 commits" 链接，就可以看到最新的提交清单，单击任何一个提交将会显示提交信息，解释提交原因。**删除信息用红色表示，添加信息用绿色表示。**

![70 1][]

![70 2][]

***查看拉请求***

用来 了解当前正在进展中的工作

![70 3][]

***查看问题***

拉请求可了解当前正在开发中的bug修复和功能建议，而查看问题可以更广泛地了解一个项目仍需做的优秀工作

![70 4][]

未完待续……

[70]: /images/20220518/3e0f4d1e8fdc40739130047036ed7e1c.png
[70 1]: /images/20220518/e65acdf5dbc24e66897d2473bd5fa3f4.png
[70 2]: /images/20220518/89f8a8d9c37f4d6fbfad5047f363f9ff.png
[70 3]: /images/20220518/1d1c8ddf0a9c4cb3889d683f26e38deb.png
[70 4]: /images/20220518/94fb140b8ba54637817fa62fee12016e.png