VS2017 Git操作教程

VS2017 Git操作教程

前言

Git是什么？

Git是目前世界上最先进的分布式版本控制系统。

那什么是分布式版本控制系统？

Git是分布式的，这意味着它并不依赖于中心服务器来保存你文件的旧版本。任何一台机器都可以有一个本地版本的控制系统，其实就是一个硬盘上的文件，我们称之为仓库（repository）。如果是多人协作的话，你还需要一个线上仓库，用来同步代码等信息。Git可以用来跟踪、记录文件的变动，经常用于开源代码。比如你可以进行旧版本恢复、比对、分析、合并等等。这个过程被称之为版本控制。

可见，Git是在多人协作的大型项目中非常有用的工具。本教程主要介绍Git在VS2017中使用。

教程的主要工作流程为：克隆/连接远程项目作为本地仓库—>创建本地分支—>修改代码—>提交项目—>同步本地代码到服务器代码—>拉取请求—>同步服务器最新代码到本地master分支—>本地自己分支与maste分支的合并。
下面为该工作流程中每一步的具体步骤和详细说明。（教程中VS与服务器默认已经建立了连接，该过程不再进行说明）

克隆/连接
克隆用于复制远程仓库代码到本地仓库。
连接作用与克隆相似，只是不需再进行拷贝，可以直接连接本地仓库。
Step1 : 建立本地仓库
建立空文件夹作为本地仓库。

Step2 : 管理连接
打开VS2017，点击【团队】下【管理连接】。

进入 “连接”界面，点击“连接到团队项目”。

Step3 : 克隆
选择服务器上对应的团队项目，这里选择项目【Train2019】。注意更改本地克隆目标位置为step1创建的仓库的路径，点击【克隆】。因step1第一次创建空文件夹作为仓库，此时VS并没有检测到git仓库的相关配置文件，故需要克隆项目。

克隆成功。

Step4 : 连接
可以看到此时本地仓库文件夹除了项目文件和文件夹外，还多出了git配置相关的文件。当再次进行管理链接时，VS会自动检测出这些配置文件，可判断文件夹下已经克隆过项目，从而会直接连接本地仓库项目，而不会克隆服务器项目。

点击【管理连接】，进入【连接】界面。

点击【管理连接】下的【连接到团队项目】。

当再次选择克隆目标位置“D:\CG\2019_TrainCode”时，原来的【克隆】按钮变成了【连接】。

Step5 : 打开仓库项目
点击VS中的【文件】，选择【打开】中的【项目/解决方案】。

选择仓库路径，打开“解决方案”。

创建本地分支
本地master分支主要用以更新服务器最新代码，所以原则上是不允许直接修改的。每个团队成员需要创建自己的本地分支，用于修改属于自己负责的代码。
Step1 : 创建分支
点击【主页】中的【分支】进入 “分支”页面。

可以看到此时本地仓库只显示一个本地master分支。

点击【新建分支】。

输入分支名，点击【创建分支】。

在本地仓库2019_TrainCode出现刚刚创建的分支cgui。

Step2：转到Master同步
Step3：转回自己分支合并

修改代码
Step1 : 切换到自己分支
原则上master分支是不可修改的，如果此时处于master分支，需要切换到自己的分支才可以进行修改代码。双击对应的分支，此处cgui加粗表明此时处于cgui分支。

Step2 : 新建XX.cpp和XX.h文件
这里我新建了222_cgui.h 和 222_cgui.cpp两个文件，可以发现新建文件前面有“+”的标号，表明该文件是刚建立的。


Step3 : 修改文件
这里我对221_caigui.cpp 做了修改，可以发现该文件前面的标号由 “锁头”状态变成“打钩”状态，表明该文件已被修改过。同理，项目前面的标号也发生改变。


Step4 : 撤销更改
右键修改过的文件，选择【撤销（U）】便可撤销更改。

可以发现撤销后221_caigui.cpp前面标号由“打钩”状态变成“锁头”状态，表明撤销成功。

提交项目
Step1 : 重新编译项目
VS编译器规定，新建XX.cpp注意添加头文件“pch.h”否则会报错。

Step2 : 提交项目
编译成功后便可右键 【解决方案】选择 【提交（I）】进行提交。

填写提交信息，点击【全部提交】。同时可看到下面的更改记录。注意此时只是创建提交的副本，并未真正提交到服务器上。

同步本地分支到源代码服务器（本地->远程）
同步本地分支代码到远程自己的分支。
Step1 : 进入“同步”页面
点击【同步】进入同步界面。

或者点击【主页】中的【同步】进入同步界面。

Step2 : 同步
点击【同步】。注意同步的作用只是同步本地自己的分支代码到远程自己的分支，此时远程master分支并未发生改变。

同步成功。

拉取请求
创建拉取请求的作用是请求审阅者批准，进批准后可将远程自己的分支合并到远程的master分支。

Step1 : 新建拉取请求
点击【主页】中的【新建拉取请求】，进入 “拉取请求”页面。

点击【新建拉取请求】。此步骤只是进入服务器网址的“拉取请求”页面，还未真正创建请求。

Step2 : 账号密码
进入服务器网址前需要填写本机用户名和密码。

Step3 : 创建请求
此时进入服务器网址的“拉取请求”页面，点击【创建】以创建请求。

Step4 : 对比修改记录
绿色背景是修改过的记录。

Step5 : 批准
可以看到 “Train2019团队”将作为审阅者，默认创建请求者也会作为审阅者之一。点击“批准”。

此时可看到审阅者“yf13”和“Tran2019”团队已批准请求。

Step6 : 完成拉取请求
点击【完成合并】即可最终完成拉取请求。

此时可看到服务器上的master分支状态已更新。

==同步本地master为服务器最新代码 ==
Step1 : 切换到master分支
双击master分支进行切换。

Step2 : 同步
切换到主页，点击【同步】进入同步页面。

再次点击【同步】即可同步服务器最新代码到本地master分支。

同步成功。

或者点击【拉取】拉取服务器最新版代码。

提示存储库已最新。

将本地自己的分支与本地master分支合并
上一步骤只是将服务器上最新代码同步到本地master分支，本地自己的分支并未发生改变，而我们一般是在自己分支上做修改，所以需要自己的分支也保持最新状态。而且每次修改代码之前都需要执行上一步骤和当前步骤。

Step1 : 切换到自己的分支
双击自己的分支进行切换。

Step2 : 合并
点击 【合并】。

将本地master分支代码合并到自己的分支代码，点击【合并】。

更新成功。

2019.04.29：加入如何将文件强制进入git仓库部分。
将文件强制进入git仓库：
1. 启动Git CMD
从开始菜单，打开Git CMD。

2. 进入到需要添加的文件目录

3. 输入命令git add . –f即可添加这个目录下的文件，进入到当前的git仓库

命令说明：
git add :表示加入git文件。
. :表示当前文件。
-f :表示文件强制加入。
4. 按照之前的步骤，提交文件即可

通过以上步骤，即可将文件强制加入到git仓库。
总结
上面的步骤对于新手来说可能有些繁琐。所以这里再做下归纳。一般首次得克隆远程项目到本地仓库，修改代码后创建提交副本，同步到远程自己的分支，再拉取请求同步远程master分支。以后想拿到远程最新版本只需要先同步远程代码到本地master，再将本地master与本地自己分支合并。整体流程就是这样的。其实只要理解每一个关键步骤的含义，就能很快熟悉整体的操作流程了。

关键步骤 ：克隆/提交/同步/拉取请求/同步master/与master合并。