这是给完全的小白看的。
不涉及代码操作。
Github作为全球最大的同性交友社区(开玩笑的),不会Github都不好意思和女友说自己是个程序猿。而个人觉得官方的教程非常简洁明了易于理解,不存在弯弯绕绕的理论,直接教小白使用方法。用着用着自然就明白了版本控制的概念。
以下为官方教程搬运,所有图片和文字资源都来源于此。文中出现的英文词都得记住。
要以下练习操作,首先要有一个Github帐号。
- 建立仓库
- 建立分支
- 修改分支并提交
- 融合分支,完成版本更新
什么是Github?
Github是一个代码存放处,可以在任何地方进行版本控制和多人合作。
这个教程包括Github的基本操作,包括建立repositories, 建立branches, 提交commits, and merge pull requests(下面会解释是什么)。你将会建立一个属于自己的Hello World 库,使用流行的Pull Request 流程来创建和复查代码。
本教程不需要敲代码!
步骤1:建立仓库(Repository)
一个Repository用于存放一个工程,可以包含任何形式的文件。我们建议您在一个Repository里默认添加一个README,或者其他说明文件。建立Repository也包含添加license等常用选项。
你的hello-word
repository可以用于存放灵感、资源以及和他人讨论。
建立新repository
- 在右上方点击"+",选择 New repository。
- 命名为
hello-world
。 - 写摘要 (description)。
- 选择Initialize this repository with a README。
![Create repo]](https://upload-images.jianshu.io/upload_images/4693292-021c2a521f7bca64.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
点击Create repository。
步骤2:建立分支(Branch)
Branch用于存放不同版本的repository。
你的主分支(branch)是master,也branch的最终版本。我们会对branch进行试操作,最终提交到master。
当你从master创建一个分支时,等同于将master复制一份放进新分支。如果有人在你正操作branch时对master作了更改,你也可以把这些更改应用到你正在编辑的branch上。
下图表示:
- 主分支
master
- 一个叫做
feature
的新分支 -
feature
被融合进master
的过程
你保存过不同版本的说明文件吗?Branches做的就是类似的事。
在Github,开发者、作者、设计人员用独立的branches修复bug和增加新功能,最后用master发布最终产品。branches修改完成后,需要融合(merge)到master。
创建新branch
- 进入你的repository
hello-world
. - 下拉branch:master.
- 在搜索框输入branch名
readme-edits
- 选择Create branch
现在你有两个分支了,master
和readme-edits
,虽然看起来完全一样。接下来改变一点东西就会不一样了。
步骤3:修改和提交(commit)修改
现在你应该进入了readme-edits
分支,是从master
复制过来的。
Github保存修改的方式叫commit,每次提交都会有一个提交信息(commit message),用于记录你作了哪些修改。Commit message会记录你在哪些地方有改变,这样其他的程序员就可以知道做了什么。
修改和commit changes
- 点击
README.md
文件。 - 在编辑器右上角点击铅笔图标。
- 编辑之
- 写下提交信息(commit message),描述修改内容
- 点击Commit changes。
修改了README文件后,你的readme-edits
branch就和master
不同了。
步骤4:打开一个Pull Request
首先打开pull request标签。
Pull Request是Github多人协作的核心。打开Pull request,你可以提交你修改后的版本(很可能你做的工程是别人的),可以让别人浏览以及让别人应用你修改的地方。Pull requests会显示修改前和修改后的对比,绿色表示增加,红色表示删除。
当你commit后,你就可以打开pull request进行讨论了。假设工程为某人的,@
某人可以让某人或团队看到你修改的版本,他们觉得没问题就会把你修改的地方merge到master。
关于pull request:
这是最关键但是最不好翻译的地方,知乎上有比较生动的解释:Github的pull request是什么意思?
给README打开一个Pull request
STEP | ScreenShot |
---|---|
点击Pull request,选择New pull request | |
选择readme-edits ,与master 对比 |
|
浏览修改的地方 | |
点击create pull request | |
给你本次Pull request起个名,写个摘要 |
步骤5:融合你的Pull request
最后一步,把readme-edits
分支融合进master
分支。
- 点击绿色的Merge pull request
- 点击Confirm merge
- 融合成功后,删除当前分支Delete branch
成功了!!!!
恭喜你完成了建立仓库、建立分支、提交修改、融合一个Pull request的过程!!!