Git命令整理

Posted on | In | |

前言碎碎念

自从使用Git作为版本控制工具以来，通过教程学习、手册查阅方式了解了Git原理和Git命令，能够顺利使用。但由于还不熟练，实践经验也还不够丰富，每次遇到问题都需要重新搜索，多次下来十分麻烦。另一方面，查阅手册往往是不够的，因为手册只会告诉你什么命令做什么用，不会根据不同场景告诉你应该用什么命令。

所以在这篇文章中，将常用的Git命令根据不同的使用场景做一个整理，加深印象的同时也方便自己日后查阅。

四个概念

借用阮一峰老师文章《常用Git命令清单》中的图。
四个概念和常用命令

  • Workspace: 工作区，也就是正在编辑的文件目录
  • Index / Stage: 暂存区
  • Repository: 本地仓库，.git文件夹管理的版本库
  • Remote: 远程仓库，例如github.com上的仓库

例如，最常用的命令串中：

1
2
3
4
5
6
7
8
$ git add <file>
#添加工作区指定文件的改动到暂存区，"<file>"为"."时添加全部改动

$ git commit -m "XXXX"
#提交暂存区的所有内容到本地仓库的当前分支

$ git push
#上传本地仓库到已关联的远程仓库

建立工程

在工作目录中建立与远程仓库关联的Git工程主要有两种情况：第一是由本地上传到远程仓库；第二是从远程仓库克隆到本地。

本地上传

这种情况下，远程应该是没有工程的。在本地工程文件夹下：

1
2
3
4
5
6
$ git init
#此时会增加.git文件夹，当前文件夹受到Git管理，并默认创建master分支

$ git remote add origin <url>
#为当前项目添加远程主机。
#其中origin为自定义的远程主机名，url为远程主机地址（推荐采用ssh协议）

此时已经建立了本地仓库与远程仓库的关联，可以通过git push推送上传。
第一次推送采用：

1
2
$ git push -u origin master
#将本地master分支推送到远程同名分支（若不存在则新建），同时-u指定origin为默认主机名，之后若要上传到origin可省略

远程克隆

这种情况下，远程仓库已经有工程，只需要在本地工程文件夹下用git clone命令克隆：

1
$ git clone <url>

此时本地仓库已经与对应远程仓库建立关联，为主机名origin的地址。

克隆其他分支

git clone命令默认克隆远程项目的master分支及其历史，若还需克隆别的分支，可通过以下方式进行（以克隆dev分支为例）：

1
2
$ git checkout -b dev origin/dev
#检出origin下的dev分支到本地新建的dev分支，并建立本地分支与远程分支的追踪关系

或

1
2
3
4
5
6
7
8
$ git checkout -b dev
#新建并切换到本地分支dev

$ git branch --set-upstream-to=origin/dev dev
#建立origin/dev远程分支和dev本地分支的追踪关系

$ git pull
#拉取本地分支dev对应的远程分支的最新状态

托管到新的远程仓库

在克隆需要的内容后，有时会希望托管到新的远程仓库。
此时可以增加新的远程主机名:

1
$ git remote add <new_remote_name> <url>

或者干脆更改原来origin的地址：

1
$ git remote origin set-url <url>

分支管理

查看分支

1
2
3
4
5
6
7
8
$ git branch
#查看本地分支

$ git branch -r
#查看远程分支

$ git branch -a
#查看所有本地分支和远程分支

新建本地分支

新建分支（不切换）：

1
$ git branch <new_branch>

新建分支并切换到新分支：

1
2
3
4
$ git checkout -b <new_branch>
#相当于：
$ git branch <new_branch>
$ git checkout <new_branch>

删除本地分支

1
2
3
4
5
$ git branch -d <branch>
#删除分支前检查该分支是否有未提交或者未合并的内容

$ git branch -D <branch>
#强制删除该分支

新建远程分支

相当于把远程未添加的本地分支push到远程：

1
2
$ git push origin <local_branch>:<remote_branch>
#建议远程与本地分支同名，同名时可省略远程分支名

删除远程分支

相当于push一个本地的空分支：

1
2
$ git push origin :<remote_branch>
#本地分支为空

或者使用--delete：

1
$ git push origin --delete <remote_branch>

合并分支

1
2
3
4
5
$ git merge <branch>
#快进合并（指针指向改变），合并<branch>到当前分支

$ git merge --no-ff <branch>
#合并<branch>到当前分支，在当前分支生成新节点，保证每个分支的独立演变史

撤销与版本回退

撤销工作区修改

有时修改工作区后，发现修改错误，希望回到原来未修改时（上一次提交或暂存）的状态。采用git checkout命令：

1
2
3
4
5
6
7
$ git diff
#查看工作区未提交（或为暂存）的文件的具体修改

$ git checkout -- <file>
#恢复工作区指定文件到上一次提交（或暂存）状态
$ git checkout .
#撤销所有工作区修改

撤销暂存

1
2
$ git reset HEAD <file>
#将指定文件撤出暂存区

版本回退

希望将版本库回退到之前的提交时，采用git reset命令：

1
2
3
4
5
6
7
8
$ git log
#查看之前的版本提交记录

$ git reset HEAD^
#回退到上一个提交版本，^^代表上两个版本，以此类推。（也可以用~2等代替）
或
$ git reset <commitID>
#commitID可由git log查看得到

有必要整理一下git reset命令的三个参数：

1
2
3
4
5
6
7
8
9
$ git reset --soft HEAD^
#重置版本库头指针，且将这次提交之后的所有变更移动到暂存区

$ git reset --mixed HEAD^
#默认参数，等同于 git reset HEAD^
#重置版本库头指针和暂存区，即这次提交之后的所有更改都留在工作区

$ git reset --hard HEAD^
#重置版本库头指针、暂存区和工作区，即这次提交之后的所有更改都不在存在于当前状态

在没有将之后的提交推送到远程仓库的情况下，git reset --hard是个很危险的操作。若是已经推送到远程仓库，使用git pull可以重新获得之后的版本提交。
若是在没有远程备份时使用--hard进行版本回退，又想恢复到之后的版本，在一定时间内（一般为30天）可以通过git reflog查看操作id，再使用git reset --hard <ID>恢复。

stash储藏

有时手头的工作进行到一半，需要切换分支做一些其他事情，可以采用git stash命令将当前的工作区储藏起来。

1
2
3
4
5
6
7
8
9
10
11
12
13
$ git stash
#储藏当前工作区

$ git stash list
#查看当前的stash储藏栈

$ git stash apply
#应用栈顶的储藏内容，恢复工作区到之前的储藏状态
$ git stash apply stash@{2}
#应用指定储藏内容

$ git stash pop
#与apply类似，但从栈中删除该储藏内容

多人协作

待续…

其他

状态查看

1
$ git status

任何情况下都可以使用git status命令查看当前的版本控制状态（包括工作区、暂存区、仓库区），并给出当前状态下可能会用到的命令提示。
经常使用该命令是好习惯。

配置git用户

1
2
3
$ git config user.name "your name"
$ git config user.email "email@example.com"
#配置当前目录的git用户，加上--config参数时配置这台机器的所有git仓库

协议更改

有时版本克隆是采用的是https协议，以至于每一次提交都需要输入用户名密码，很麻烦。而使用ssh协议就会方便很多，需要将当前的仓库协议进行更换。
事实上，重置远程仓库名为ssh协议地址就可以了。

1
$ git remote origin set-url git@example.com....