【工具】---- Git 使用说明

一、Git 简介

Git 是一个开源的分布式版本控制系统，用以有效、高速的处理从小到非常大的项目版 本管理，github、gitlab 等都是基于 git 来开发的，Github 是一个开源网站，提供给开发 者空间创建 git 仓库，保存用户的一些数据文档或者代码， Gitlab 是一个基于 git 的项目 管理软件，一般用于企业、学校等内部网站搭建 git 私有服务器，下面主要介绍的是 gitlab 的基本使用。

二、 环境搭建

2.1 安装 Git for windows

Git for windows 提供了一种在 windows 下 git 的命令行操作工具，和 linux 一样的操 作，下载地址 https://git-scm.com/downloads，根据自己电脑选择相应版本，以管理员身 份运行，使用默认安装即可，安装完后在任意目录下右键单击，选择 Git Bash Here,在命 令行下输入 git –version，查看版本， 如图 2-1 所示，安装成功。

2.2 安装 TortoiseGit

TortoiseGit 简称 tgit, 后续简称小乌龟， 是一个开放的 git 版本控制系统的源客户 端，由于 git 命令之多，有些命令可能记不住，而且有些命令使用起来比较麻烦，影响效率， 比如解决合并过程中的冲突，命令行操作就比较费劲，但是小乌龟操作很快而且比较直观， 所以我们在使用 git 时，通常是命令行+图形界面结合来使用，提高开发效率。下载地址 https://tortoisegit.org/download/，使用默认安装即可，如果需要支持中文界面，请安 装 TortoiseGit-LanguagePack，使用默认安装即可，到此图形界面工具安装完成。

2.3 软件设置

空白处右键单击，选择 TortoiseGit->Settings，如图 2-2 所示。

选择 Re-run First Start Wizard，设置语言，如图 2-3、2-4 所示。


设置完语言之后，单击 下一步，设置 git 路径，并查看 git 版本，如图 2-5 所示。

单击 下一步，设置用户名和邮箱，如图 2-6 所示。

配置用户信息，根据自己习惯，选择配置的方式。

（1）小乌龟配置
选择 TortoiseGit->Setting，设置如图 2-7 所示。

注意：使用 Global 参数，表示你这台机器上所有的 Git 仓库都会使用这个配置。

（2）命令行配置

选择 右键单击 Git Bash Here，输入命令 git config –global user.name “yourname” 回车，输入命令 git config –global user.email“youremail@qq.com”回车, 设置如图 2-8 所 示。

2.4 SSH 密钥注册

为了方便操作，添加密钥至 Gitlab，这样每次将本地代码提交到远端时，就不需要输 入密码验证。

2.4.1 查看 .ssh 文件是否存在

在 Git Bass Here下输入命令 : cd ~/.ssh, 显示如下界面证明.ssh文件存在。若没有，手动生成

2.4.2 生成.ssh文件
生成秘钥：ssh-keygen -t rsa -C “your_email@youremail.com” ，直接Enter就行，然后会提示输入密码(可输可不输)
说明：命令中的email，就是gitlab中的账号，需要保持一致

执行完成之后，在.ssh 目录下就会生成秘钥文件（没有.ssh目录的会自动生成，手动创建的则不会重复生成）

2.4.3 注册密钥
使用记事本打开 id_rsa.pub 文件，全选并复制，然后再打开 gitlab， 在搜索框中搜索：SSH Keys

•点击 Add SSH Keys

2.5 小乌龟添加秘钥

如果不执行这一步，不能正常使用乌龟操作。首先打开小乌龟 安装目录，下面是我的安装路径，找见 puttygen.exe，双击打开，如图 2-12 所示。

这里导入前面生成的密钥，~/.ssh/id_rsa，注意不是后缀为 .pub 的文件，选择文件 后，出现如图 2-14 所示的界面，key 已经被添加进来了，再选择 save private key 将转换 后的秘钥文件保存在 .ssh 路径下。


注：Key comment 这里显示的如果是繁体字，证明前面的tortoise步骤是错误的，应该回到之前的步骤，重新添加秘钥。

保存完秘钥后，鼠标右键打开 Git clone 选项，如图 2-16 所示，使用小乌龟克隆远端 代码，第一次需要输入 URL 地址，注意复制远端 git@开头的链接，然后选择本地仓库存放 路径，选择一个自己的路径，接着添加刚才保存在.ssh 路径下的 .ppk 文件，最后点击 OK, 密钥注册成功，接下来就可以正常使用小乌龟操作了。

注：右击时若无Git clone选项，时，将鼠标定位到任意一个文件夹下再右击即可


安装激活步骤到此完成。

三、 Git 基本操作（开发流程）

3.1 克隆远端仓库

注：登录gitlab，必须先连接VPN。

在本地先创建一个自己的工作目录，然后复制远端仓库链接，如图 3-1 所示

注：下面的操作，小乌龟和命令行任选其中一个即可。

3.1.1 小乌龟克隆
进入自己本地工作目录，右键选择 Git 克隆， URL 填入复制的链接，目录就是当前路
径，点击确定开始克隆，如图 3-1、3-2 所示。


3.1.2 命令行克隆
右键选择 Git Bash Here，输入命令 “git clone 远端仓库链接”，回车开始克隆，
如图 3-3 所示。

3.2 更新本地仓库

远端仓库的代码是通过多人开发的，每个人都可以更新远端仓库，提交最新代码，所以 我们在本地修改代码前，首先切换到 master 分支，再拉取远端仓库 origin master 最新的代码，更新完之后，在 master 分支下创建一个新的分支，分支名按照具体功能命名 eg: 串 口驱动开发，取名 drv_uart， git bash 命令： git checkout –b drv_uart，在当前分 支下进行开发。

3.2.1 小乌龟更新本地仓库

在本地仓库路径下，右键 TortoiseGit->拉取(pull), 如图 3-4、3-5 所示。


查看差异，选择 拉取到的差异，因为当前是一个用户操作，所以没有差异，这里只做一个说明，如果有多个人开发，拉取时可能会有显示差异，如图 3-6 所示。

3.2.2 命令行更新本地仓库

右键选择 Git Bash Here，输入命令 “git pull origin master”进行拉取操作，如
图 3-7 所示。

3.3 创建和切换分支

3.3.1 小乌龟创建新的分支
右键选择 TortoiseGit-〉创建分支，填写分支名并切换到新的分支下，如图 3-8 所示。

切换分支，如图 3-9 所示。

3.3.2 命令行新建和切换分支
右键 Git Bash Here，输入命令 git checkout –b xxx 创建分支，输入命令 git
checkout xxx 切换分支 如图 3-10 所示。

3.4 添加新文件

如果在本地增加了新的文件，需要添加到本地 git 仓库进行管理。
3.4.1 小乌龟添加新文件
右键 TortoiseGit-〉添加(add)，选择需要添加的新文件，如图 3-11 所示。

3.4.2 命令行添加新文件
右键 Git Bash Here，输入命令 git add 需要添加的新文件 或者 git add . 添加
所有的新文件，如图 3-12 所示。

3.5 提交修改

当修改完文件，并且已经添加到本地版本库了，则进行提交操作。
3.5.1 小乌龟提交
右键 TortoiseGit-〉提交(commit)，填写修改日志，方便信息回溯，如图 3-13、3-14 所示。


3.5.2 命令行提交修改
右键 Git Bash Here，输入命令 git commit –m “提交日志”回车提交，如图 3-15 所示，注意，命令行提交之前一定要先使用 git add 添加被修改的内容， 提交修改建议在 小乌龟下操作。

3.6 合并分支

当前分支代码如果修改完成，需要验证时，合并到工作分支进行验证。
3.6.1 小乌龟合并
右键 TortoiseGit->合并，如图 3-16、3-17 所示。


3.6.2 命令行合并分支

右键 Git Bash Here，输入命令 git merge 分支名，如图 3-18 所示。

3.7 推送到远端服务器

提交完修改后，就可以将本地版本库推送到远端版本库。

3.7.1 小乌龟推送

右键 TortoiseGit->推送，填入 URL 链接，如图 3-19、3-20 所示。


3.7.2 命令行推送

右键 Git Bash Here，输入命令 git push origin drv_uart， 注意这里不能直接推
送 master 分支，如图 3-21 所示。

3.7.3 创建合并请求

如图下图所示。


到此，完整的一次开发流程结束，联系仓库管理员合并代码。

四、总结

以上只是列举了 git 最基本的一些操作，还有很多需要在使用的过程中熟悉和掌握，更
加详细的说明请查看 廖雪峰 Git 教程
网站地址：https://www.liaoxuefeng.com/wiki/896043488029600
常用 git 命令：

git clone git@192.168.3.100/lmiracle/frost_warning.git   克隆远端仓库 

git checkout –b xxx 创建新的分支 

git checkout xxx 切换到 xxx 分支 

git status 查看当前状态 

git pull origin master 更新远端版本库到本地 

git add test/xxx.c 添加 test 目录下的 xxx.c 文件 

git add . 添加当前分支下 所有新增文件 

git commit –m “日志信息” 提交本地版本库 

git push origin xxx 将当前分支的提交推送到远端 

git log 查看日志 

git diff 查看修改信息 

git branch –a 查看当前所有分支