Git使用指北

本文主要介绍Git软件和Github在Windows平台的简单使用方式

安装Git

安装包可以在官网下载,选择对应版本无脑下一步安装

初次设置

安装完成后,邮件菜单即可调用Git命令,点击进入后需要初始化账户名和邮箱

1
2
git config --global user.name "Your Name"
git config --global user.email "email@example.com"
生成SSH Key
1
ssh-keygen -t rsa -C "youremail@example.com"
  • 一路Enter键后会需要设置自己的账户和密码,注意正确输入
  • 然后在C:\Users\你的用户名\.ssh路径下可以找到如下3个文件

  • 后缀为pub的文件,这个是公钥,在后续会用的到,也可以放心的告诉别人
  • 后缀为rsa的是私钥,不要泄露出去
关于SSHKey

GitHub需要识别出你推送的提交确实是你推送的,而不是别人冒充的,而Git支持SSH协议,所以,GitHub只要知道了你的公钥,就可以确认只有你自己才能推送。

当然,GitHub允许你添加多个Key。假定你有若干电脑,你一会儿在公司提交,一会儿在家里提交,只要把每台电脑的Key都添加到GitHub,就可以在每台电脑上往GitHub推送了。

注册GitHub账户

  1. github官网自行注册并登录
  2. 右键点击右上角头像边的箭头,选择setting进入

  1. 找到左侧的SSH and GPG keys,点击NewSSHKey

  1. 找到之前生成的公钥文件,用记事本打开复制里面全部内容,然后粘贴到如下图key 内,点击AddSSHKey完成,

使用Git

创建本地仓库
  • 在桌面直接右键进入git
1
2
3
4
cd E:/     --进入E盘
mkdir GitTest --创建文件夹GitTest
cd ./GitTest --进入GitTest文件夹
git init --初始化

如上述代码所示,完成在E盘新建文件夹然后初始化的过程,其中前三步非每次必须,可以直接手动创建文件夹,然后通过git init初始化

提交本地文件
1
vim test.txt --新建文件

按键盘Insert键进入编辑模式,输入hello,然后按顺序ESC,:,wq退出

上述步骤完成了创建文件,写入退出的过程,到此生成了文件和内容如下图

对,一顿操作猛如虎,回头一想就是Linux那一套☠

  • 上述步骤完全可以自行创建和编辑内容,然后我们开始提交
1
2
git add test.txt //提交text.txt文件到待提交列表
git commit -m "第一次提交" //正式提交到仓库

至此我们已经提交到了本地仓库,可以通过命令git log 查询日志找到记录

添加远程仓库

到这一步我们得先创建一个远程仓库,来到我们github,通过Your respositories>New创建新的仓库,这里我们创建了名为Test 的仓库

  • 找到如下图所示,复制地址信息(推荐使用SSH,使用HTTPS经常需要输入账户)

然后运行git命令

1
git remote add origin "你的地址" //添加远程仓库地址
提交/拉取远程仓库
1
git add push origin -u master //master为当前分支,默认一般就是master,可以自行修改,下同

到这里就提交到了远程仓库,如下图所示

1
git pull origin master 

从远程仓库拉取master分支的内容

取消关联远程仓库
1
git remote rm origin
新建分支
1
2
3
4
5
6
7
8
9
10
11
// -b是base的意思,就是以当前分支为基础创建一个新分支 
git branch ${new_branch_name} -b
// 切换分支
git checkout ${new_branch_name}

// 也可以使用git checkout命令加上-b参数表示创建并切换
git checkout -b ${new_branch_name}

//相当于以下两条命令:
git branch ${new_branch_name}
git checkout ${new_branch_name}
Checkout的用法

checkout有三种用途:切换分支、移除修改、从历史版本中签出,后面会写到

1
2
3
4
5
//从远程的origin/level为基础创建本地分支
git checkout -b level origin/level
//上面的命令等同于下面两条
git checkout -b origin/level
git branch -m level
推送本地当前分支到远程分支
1
2
// 若远程不存在${new_branch_name}分支则会自动创建
git push ${remote_repo_name} ${new_branch_name}
合并分支
1
2
3
4
5
// 首先需要切换回需要合并到的分支,比如将dev分支合并到master分支
git branch master
// 将dev分支合并到当前分支
git merge dev
// 合并完毕后就可以删除dev分支
取消合并

如果本地与远程分支(或本地分支)有冲突可以取消合并,使本地分支回到合并之前的状态。

1
git merge --abort
解决冲突

在使用git协作开发的时候,冲突是经常会遇到的问题,也是对于新手来说非常棘手的问题

  • 首先我们要在本地处理好自己的文件
撤销修改
1
2
3
4
git checkout -- test.txt  //撤销对test.txt文件的修改
git checkout -- . //撤销本次所有文件的修改
git reset -- test.txt //如果已经add了test文件,需要先使用本条命令退出add状态
git reset -- . //撤销所有文件的add状态
解决拉取冲突

如果在拉取以后发生冲突了,在拉取日志里就有报错,通过git status命令也可以看到有红色部分,通过下列命令解决

如果我们要保留远程分支的test.txt可以执行以下命令:

1
2
// 保留远程版本的test.txt
$ git checkout --theirs test.txt

而保留本地分支的文件命令为:

1
$ git checkout --ours test.txt

然后再此执行如下命令,注意这会再一次生成提交记录

1
2
3
4
$ git add test.txt
//假如上面执行的是 --theirs
$ git commit -m "合并冲突,保留远程版本"

此时本地就与远程合并了,并且合并时保持了远程的文件版本。

回退版本

如果想要取消本地的某次提交${123456}的更改可以使用回退到历史版本,然后使用:

1
2
3
4
5
git reset --hard 123455
//将123456提交的文件签出到123455的提交中去
//相当于直接在123455的基础上做了123456中的文件修改
$ git checkout 123456 .
//然后在reset/checkout不想提交的文件即可
删除分支
1
2
3
4
5
6
7
8
// 删除本地分支
// 注意:删除分支之前要合并分支,不然会报错(或者使用-D强制删除)
// error: The branch 'dev' is not fully merged.
// If you are sure you want to delete it, run 'git branch -D dev'.
git branch -D dev

// 删除远程分支
git push ${repo_name} --delete ${remote_branch_name}
版本回退
1
2
3
git log --pretty=oneline  //查看所有提交记录
git reset --hard "版本号" //回退到某个版本,版本号为查询记录里黄色部分
git reset "版本号" "filename" //某个文件回退到某个版本
克隆远程仓库
1
2
3
4
// clone仓库所有分支
git clone "仓库地址"
// 只clone一个分支可以使用-b指定分支名字
git clone -b "分支名称" "仓库地址"
切换到远程分支

远程仓库 git clone 下来后,执行 git branch,只能看到

1
* master

并不会看到其他分支,即便远程仓库上有其他分支。

可以使用git branch -va首先列出本地/远程分支列表:

通过git checkout remotes/origin/master切换到远程分支

再进行如下操作

1
git checkout -b dev

最后得到如下结果

然后在本地修改dev分支的内容就可以提交到远程dev分支(此案例远程没有dev分支)

##### 忽略不想提交的文件

有时我们不想要把所有的东西都提交到仓库中(比如一些编译生成的二进制文件),可以使用.gitignore来排除不需要提交的文件。
在Windows下我们不能够直接创建这个文件,因为是.开头没有文件名,所以需要在GitBash下使用命令创建:

1
touch .gitignore //创建文件

然后用记事本打开编辑里面的内容并保存

1
2
3
4
5
6
7
8
9
//排除当前目录下的public文件夹
public/
//排除所有的.exe文件
*.exe
//排除所有的txt文件
*.txt
Intermediate //排除Intermediate文件的提交
Saved
Content/Test/

其中在上述最后3条对于UE4的开发比较常用

关于忽略文件的更多内容,可以查看此文档

比较不同版本的差异

我们继续在test.txt文件加入一行world,然后运行

1
git diff

得到如下

其他命令

1
2
3
4
5
6
7
8
9
10
//查看尚未暂存的某个文件更新了哪些
$ git diff filename
//查看已经暂存起来的文件和上次提交的版本之间的差异
$ git diff –cached
//查看已经暂存起来的某个文件和上次提交的版本之间的差异
$ git diff –cached filename
//查看某两个版本之间的差异
git diff ffd98b291e0caa6c33575c1ef465eae661ce40c9 b8e7b00c02b95b320f14b625663fdecf2d63e74c
//查看某两个版本的某个文件之间的差异
git diff ffd98b291e0caa6c33575c1ef465eae661ce40c9:filename b8e7b00c02b95b320f14b625663fdecf2d63e74c:filename

两个分支的差异

1
2
3
git diff topic master (1)
git diff topic..master (2)
git diff topic...master (3)

用法1,直接跟两个使用空格分隔的分支名会直接将两个分支上最新的提交做diff,相当于diff了两个commit。
用法2,用两个点号分隔的分支名,作用同用法1(装酷利器)
用法3,用三个点号分隔的分支名会输出自topic与master分别开发以来,master分支上的change。
需要注意的是这里的..和…不能与git rev-list中的..和…混淆。

错误处理

如果使用git终端时出现以下错误:

1
2
3
git status
error: bad signature
fatal: index file corrupt

这是由于索引损坏造成的,可以通过下面的方式来处理:

1
2
rm -f .git/index
git reset
关闭Git的SSL验证
1
git config --global http.sslVerify false
私钥权限过于开放报错

使用git出现如下报错

1
2
3
4
5
6
7
8
9
10
11
12
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: UNPROTECTED PRIVATE KEY FILE! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/root/.ssh/id_rsa' are too open.
It is required that your private key files are NOT accessible by others.
This private key will be ignored.
Load key "/root/.ssh/id_rsa": bad permissions
Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

这是提示你的Git私钥读写权限过于开放会有安全问题

解决方法:对文件.ssh/id_rsa点右键属性-安全/高级,禁用继承,将文件所有者更改为你自己的账户,然后添加你自己的账户和SYSTEM完整的控制权,保存即可。

Git更新远程分支列表
1
git remote update origin --prune
submodule

如果再一个git仓库中又用到其他git仓库的,就可以使用git module来处理这个包含关系。

如果直接在git仓库A中把另一个仓库B clone下载作为A的子目录,在git add时会有下列类似的提示:

1
2
3
4
5
6
7
8
9
10
11
12
13
hint: You've added another git repository inside your current repository.
hint: Clones of the outer repository will not contain the contents of
hint: the embedded repository and will not know how to obtain it.
hint: If you meant to add a submodule, use:
hint:
hint: git submodule add <url> Plugins/VaRest
hint:
hint: If you added this path by mistake, you can remove it from the
hint: index with:
hint:
hint: git rm --cached Plugins/VaRest
hint:
hint: See "git help submodule" for more information.

目的就是告诉你你包含了另一个git的仓库。

正确的处理办法是,先把之前clone的B删除,然后使用git submodule来clone B:

1
2
3
4
5
6
7
8
9
10
11
$ git submodule add git@github.com:VJien/img.git
Cloning into 'E:/GitTest/img'...
remote: Enumerating objects: 123, done.
remote: Counting objects: 100% (123/123), done.
remote: Compressing objects: 100% (118/118), done.
remote: Total 123 (delta 39), reused 0 (delta 0), pack-reused 0
Receiving objects: 100% (123/123), 4.05 MiB | 466.00 KiB/s, done.
Resolving deltas: 100% (39/39), done.
warning: LF will be replaced by CRLF in .gitmodules.
The file will have its original line endings in your working directory

会把B clone下来,然后进到B的目录里面,将版本记录改为你想要的commit,然后再add/commit即可。

1
2
3
4
5
6
git status
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)

modified: Plugins/VaRest (new commits)

然后再push到远程仓库即可,在远程仓库中,A项目中的B目录就不是直接上传的文件,而是连接到真正的B的源仓库。

初始更新子模块
1
git submodule update --init --recursive
后续更新子模块
1
2
3
git submodule foreach git fetch
//或
git submoudule update --remote
删除子模块

删除一个以添加的子模块需要有以下几个步骤:

  1. 删除子模块的目录
  2. 删除.gitmodules中的关于该子模块的信息
  3. 删除.git/config中关于该子模块的信息
  4. 删除.git/modules下该子模块的目录

执行完上面几步操作之后就可以了,但是如果有报错问题可以删掉缓存:

1
git rm --cached 子模块名称
创建本地空仓库

个命令是创建一个空仓库,可以在其他的项目中将该仓库添加为远程仓库。

1
git --bare init

部分内容参考至本人好友查理同学的☛博客