一次完整的git安装以及项目提交流程

最近学习数据结构与算法时，想把自己写的一些代码提交到GitHub上与大家交流分享，关于mac环境下的配置资料相对较少，于是记录一次自己用mac来配置git并向github上提交代码。

一、下载git客户端程序

下载地址：https://git-scm.com/download/mac（官网地址）
点击上面的地址来下载最新的git程序，官网目前最新的版本是2.27.0，我使用的版本是2.23.0
（本人使用编程软件一般都不使用最新版本，因为最新的版本会有一些bug或者版本不稳定，大家可以根据自己喜好来选择）

下载完成后，在mac中查看文件界面如下所示：

二、安装git

这里安装会有一个小问题，简单说一下pkg和dmg的区别。（详细请百度、Google）

后缀为.pkg是安装包配置文件，可以理解为制作win系统下exe文件的一个包，里面包含了制作这个.exe文件的所有信息。运行.pkg的权限比较高，需要sudo权限。
后缀为.dmg是mac上的压缩镜像文件，相当于win系统下的iso文件。是可以直接点击运行的。

所以在这里直接双击是无法打开的，需要右击 “git-2.23.0-intel-universal-mavericks.pkg” 文件点击 “打开”


按照提示一直进行下一步安装即可，安装完成后如下图。

打开terminal 输入git --version来检查一下是否安装成功，若出现下图中 “git version 2.23.0” 即为成功。

三、创建SSH并连接GitHub

（1）打开terminal，输入 cd ~/.ssh 如果出现“cd: no such file or directory: /Users/你的用户名/.ssh” 。说明之前没有用过，直接输入ssh-keygen -t rsa -C 123456@123456.com(你的邮箱名字)。成功创建之后再次进入 ～/.ssh文件中可以看到有两个文件，一个是公钥（id_rsa.pub），一个密钥（id_rsa）。
密钥要保存在自己电脑中，将公钥内容拷贝至github上来建立ssh的连接。

【注意！！！】要妥善保管自己的密钥！！！因为一旦密钥丢失或者被其他知道，将会被用来解密公钥！！！也就不能保证数据和内容的安全性了！！！

（2）复制公钥的内容，有两种方法。
其一：是通过命令vim直接打开公钥进行复制。
其二：通过命令phbcopy < ~/.ssh/id_rsa.pub 将公钥的内容复制一份。

（3）登录GitHub（如果没有的话自行注册一个即可）
点击右上角的个人头像找到其中的【Settings】选项点击进入。

选择【SSH and GPG Keys】后点击【New SSH key】

粘贴过来之后，点击【Add SSH key】即完成了添加操作。

（4）测试是否连接成功
第一次尝试连接时会出现一段话 ，其中 “Are you sure you want to continue connecting (yes/no/[fingerprint])? ” 直接输入yes即可，这是再次询问你是否同意连接。

输入 yes 后回车等待几秒钟，如果出现下面这一句话：
“Hi (你的用户名)! You’ve successfully authenticated, but GitHub does not provide shell access.”
表示你已经连接成功了。

四、创建一个自己的仓库（repository）

在右上角有一个 “➕” 点击之后选择【New repository】即可。

出现如下界面后，填写好自己仓库的名字，可以对该仓库进行一个简要描述，以便于以后知道该仓库是用来做什么的。可以选择勾上【Initialize this repository with a README】，看过很多大神的资料之后，发现这个【README.md】
是一个很好的目录结构（个人这么理解哈），可以清晰的表明你的项目的所有内容，让别人清楚的了解你所做的内容以及如何使用你的项目。而且个人觉得更有助于锻炼自己对于一个项目的宏观把握，还是写写为好。

成功之后如下图所示。

五、通过git命令来将项目上传到GitHub中

在GitHub上该项目仓库是空白的，可以通过这个仓库来克隆一个新的仓库，也可以把一个本地已经存在的仓库与之关联，然后把本地仓库的内容推送到GitHub上。

【注意！！！】既可以在空目录也可以在已有的目录下来创建Git仓库。

（1）初始化Git仓库
我在本地建立了一个Algorithm_training项目，现在想把这个项目通过git上传到GitHub上。
首先在terminal 中输入命令cd ~/IDEA/ProjectName进入你的项目中。然后输入命令git init进行Git仓库初始化（创建一个仓库），会有一行字显示这是一个空的仓库（empty Git repository），使用命令ls -all会看到多出一个.git文件夹，这是Git用来跟踪管理版本库的一个目录，里面的结构和内容不需要动，由Git自己管理。

（2）使用git命令将项目添加到仓库中
使用命令git add *来将所有的项目文件全部添加到仓库中，执行完命令后没有任何显示即添加成功。

（3）把项目文件提交到仓库中
使用命令git commit - m "注释"来将已经添加到仓库的项目文件提交。

【注】与add命令不同的是，commit才是真正的提交操作，而add只是将项目文件暂存到仓库中，并未真正的提交，相当于只是添加文件到一个工作平台暂存。
第一次设置并提交时候会出现如下问题：

这里是因为没有设置本机的用户名和邮箱地址，当第一次安装完Git后需要对自己的机器做一个标识，每次提交项目都需要用到这个标识，因为远程库是需要知道谁在提交项目。
由于我第一次设置，安装并没有配置用户名和邮箱地址，所以这里配置一下（可以在安装完Git后就直接配置这个信息，只需要做一次就可以了）
通过git config --global user.email配置邮箱地址
通过git config --global user.name配置用户名
通过git config --list 查看是否配置好，若有user.email = 你配置的地址和user.name = 你配置的用户名则说明成功了。

另外，--global是可选项，选择了该选项则表明Git每次操作都会使用该用户名和邮箱地址，如果想在不同的项目中使用不同的名称和邮箱地址来进行提交，可以不添加这个选项。

配置完用户名和信息再重复【三】的操作即可提交成功。

（4）添加远程库
输入命令：git remote add origin "SSH key"其中origin是Git对远程库的默认写法，可以修改为其它的名称，如test、fighting等等，它是你后面要写的SSH Key的另一种名称，是为了远程库在本地的一个别称，方便添加使用而已。
【SSH Key】通过再GitHub上对应项目的【Clone or download】里找到的，直接拷贝过来即可。
完整git命令：git remote add origin git@github.com:你的用户名/你的项目名.git
完成添加后若没有任何提示，说明添加成功。

（5）将本地库内容推送到远程库
首先要注意的一点就是，如果远程库比本地库要新的话，应该先pull一下，将远程库拉到本地，再进行push操作，这样就不会导致库的不一致了，也就会避免很多错误，如果远程库比本地库旧，那就可以直接push操作。
由于我在远程库GitHub上创建了一个新的README文件，所以我这里要先pull一下，再做push操作。不然无法直接提交到远程库中去。
使用命令：git pull origin master后，这时会出现下面一段话

原因是由于合并了两个不同时间点开始提交的仓库， git 会认为这两个仓库有可能不是同一个，为了防止开发者上传错误，所以会出现该提示。需要在原命令后再加上一条语句来确认。即--allow-unrelated-histories
完整命令：git pull origin master --allow-unrelated-histories,之后出现下面图，直接：wq退出即可。
保存退出后会出现一个【README.md】文件，本地便与远程库保持一致，可以执行push操作了。

查看本地项目文件也可以看到这个【README.md】文件（使用ls命令，这里就不再赘述了）

此时再执行push命令：git push -u origin master，成功之后会出现下图。

提交项目代码到GitHub之后可以在自己GitHub上查看会发现出现了本地仓库中的代码。

到此一次完整的安装Git以及提交项目操作流程就结束了。

【注意⚠️】

每次使用git提交代码时候，一定要注意顺序

1.add（将更新的项目添加到暂存平台中）

2.commit（提交到本地仓库中）

3.pull（从远程库拉取最新的，以防出现错误）

4.push（将本地更新的代码直接推送到远程仓库中）

（关于本篇使用到的部分git命令，可以百度一下，有很多优秀的资料可以学习，其实也不是很难）