2018-09-29#course#版本控制入门-Github客户端

---

前言-为什么选择github?

• Git-版本控制工具，可以安装在自己电脑上的软件
• github公司对Git进行了推广，表现为github.com-全球最大的开源项目托管平台

• github让Git的使用变得更易用。
  Git本来是一套命令行工具，学习有一定的门槛，本教程使用github网页和客户端展示一套最简单的版本控制思路

  
  
  

  image.png

创建账号，客户端的安装

1. 进入GitHub官网https://github.com/
   
   
2. 填好用户名，邮箱，密码。点击“Sign up for Github”按钮
   注意注册过程中可能会让你选择一些付费信息，github上面如果要创建私有项目是需要付费的，我们选择free就好。
3. 进入github下载网站https://desktop.github.com/
   
   

   github客户端下载界面.png

浏览器中使用Github（基本操作）

1. 创建新项目
   

   
   
   
   
   
   
   

2. 添加团队成员

• 点击“Setting”，选择左侧“Collaborators”，填写队员的用户名

  
  
  
• “Add collaborator”

3. 项目中添加文件

   
   
   
   
   
   

• 点击commit

  
  
  

  改版历史线.png
  
  

  点进去可以看到该版本的详细修改信息

以上就是如何创建、修改项目，做版本，查看历史上版本的修改内容等基本操作。但是很多项目都要在本地写，本地有编译调试的环境。所以下面介绍用图形化的客户端管理本地项目的版本控制操作

客户端使用Github（基本操作）

1. 创建或clone项目

   
   
   

   客户端首页.png

• Create：本地和github上都没有项目。重新创建一个项目
• Add：本地有一个项目，网页上没有。将这个项目加入github

• Clone：github上已经有这个项目，克隆到本地，其实就是下载到本地
  这里将已经在github上的项目“DemoProject”克隆下来

  
  
  
  
  
  

  image.png
  
  
  

  image.png

2. 添加/修改项目

• 写在开头：每次对项目进行修改之前首先更新本地项目，保持本地和github网站上的一致性，避免冲突

  
  
  

• 添加“HelloWorld.cpp”文件

  
  
  

• 客户端显示

  
  
  

  image.png

• 想要提交这次修改，添加这次修改的描述

  
  
  

  image.png

• 本地提交之后

  
  
  

  image.png
  
  

  注意：以上只是提交到本地仓库

3. 提交到github网站上

• 切记：提交之前，需要先进行更新"Repository"-”Pull“

• 点击上图右上角“Push origin”,之后显示"Fetch origin"则为提交成功

  
  
  

  image.png

4. 解决冲突
   即使每次修改项目前后都更新了本地代码，仍然会出现冲突。比如：当你修改代码之后，想把代码传到github网页上。但是在你修改代码期间，一队友也修改了同样位置的代码。则会出现冲突。如下例：

• 此时我增加了一句话

  
  
  

  image.png

• commit到本地仓库，"Pull"，然后Push到github网页。但当pull之后，会显示以下冲突提示

  
  
  

  image.png
  
  
  

  image.png

• 点击”View conflics“，进行冲突的查看。

  
  
  

• 手动解决则需要在本地打开有冲突的文件。我们打开"HelloWorld.cpp"

  
  
  

  image.png
  
  

  上面箭头标识了代码冲突的部分，=====分隔符将远端和本地的代码分隔开。HEAD表示本地的代码，分隔符下面代表远端仓库的代码。这时候需要和队友达成一致，这里商量之后决定保留YU的代码。那么就删掉本地代码部分。保存之后，客户端会有一个change

  
  
  

  image.png
  
  这里的版本会自动生成一个描述”Merge...“

• 点击commit(提交到本地仓库)，pull(更新)，push(提交到远端仓库)

  
  
  

  image.png

以上就是在一个master分支上进行团队合作的基本操作。更多的github的分支操作和高级操作见后文。

Github基本操作（分支操作）

//TODO

内部团队合作方式（适用于熟悉的小团队）

//TODO

开源项目贡献

//TODO