Git命令总结

现在用的最多的代码版本控制软件应该就是Git了，虽然开发的时候每天都需要用，但是如果中间断了一段时间，很容易忘记。以下为常用的几个命令组成的一张图：

下面是Git中的几个区域的专有名词：
- Workspace：工作区，我们增删改查文件的地方
- Index/Stage：暂存区，可以多次从工作区提交修改到这，然后作为一次提交到加入到仓库
- Respository：仓库区（本地仓库），保存有所有历史版本
- Remote：远程仓库，所有人的本地仓库可以与其保存同步

帮助

Git是由一个个子命令组成的，而学习一个命令的时候最重要就是练习和不断查看其帮助文档

# 查找总帮助文档
$ git help [-a|-g]
$ git --help

# 查看特定Git子命令帮助
$ git help <命令>
$ git <命令> --help

新建代码库

# 从远程仓库下载一个项目
$ git clone (url)

#在当前目录新建一个Git代码库
$ git init
# 新建一个目录，并将其初始化为一个Git代码库
$ git init <project_name>

配置

Git的配置文件为.gitconfig，它可以在用户目录下（全局配置），也可以在项目目录下（项目配置）。

# 设置提交代码时的用户信息
$ git config [--global] user.name "<name>"
$ git config [--global] user.email "<email address>"

# 显示当前的Git配置
$ git config --list
# 编辑Git配置文件
$ git config -e [--global]

查看信息

# 显示所有变更的文件，也是获取当前`Git`状态
$ git status

# 显示当前分支的版本历史[详细信息]
$ git log [-p]
# 显示commit历史，以及每次commit发生变更的文件
$ git log --stat
# 显示某个文件的历史版本，包括文件改名
$ git log --follow <file>
$ git whatchanged <file>
# 显示指定文件相关的每一次diff
$ git log -p <file>
# 显示当前的指定文件是什么人什么时间修改过
$ git blame <file>

# 显示暂存区和工作区的差异
$ git diff [file]
# 显示暂存区和上一个commit的差异
$ git diff --cached [file]
# 显示工作区也当前分支最新的commit之间的差异
$ git diff HEAD
# 显示两次提交之间的差异
$ git diff <first_commit> <sencond_commit>

# 显示某次提交的元数据和详细的内容变化
$ git show <commit>
# 只显示某次提交变化的文件名和log
$ git show --name-only <commit>
# 显示某次提交，某个文件的变化
$ git show <commit>:<file_name>

# 显示当前分支的操作记录
$ git reflog

增加/删除文件

# 添加指定文件到暂存区
$ git add [file1] [file2] ...
# 添加指定目录到暂存区，包括子目录
$ git add <dir>
# 添加当前目录的所有文件到暂存区
$ git add .

# 删除工作区文件，并将这次删除放入暂存区
$ git rm [file1] [file2] ...
# 停止追踪指定文件，但该文件还会保留在工作区
$ git rm --cached <file>

# 文件改名，并将这次改名放入暂存区
$ git mv <file_orginal> <file_renamed>

代码提交

# 提交暂存区到本地仓库区
$ git commit [-m <log>]
# 提交暂存区的指定文件到仓库区
$ git commit [file1] [file2] ... [-m <log>]

# 提交工作区自上次commit之后的所有变化，直接到仓库区
$ git commit -a
# 提交时显示所有diff信息
$ git commit -v

# 把当前暂存区追加提交到上个commit，并修改log
$ git commit --amend [-m <log>]
# 修改未推送到远程仓库的几次commit
$ git rebase -i

撤销

# 撤销某个文件工作区的修改，恢复到暂存区状态
$ git checkout [--] <file>
# 恢复某个commit的指定文件到工作区
$ git chekcout <commit> <file>

# 重置暂存区，与上一次commit保持一致，但工作区不变
$ git reset [file]
# 重置暂存区和工作区，与上一次commit保持一致
$ git reset --hard [file]
# 重置当前HEAD为指定commit,但保持暂存区和工作区不变
$ git reset --keep <commit>

# 新建一个commmit，用来抵消指定commit
$ git revert <commit>

git reset 也可用于reflog来撤销某个操作。

远程同步

# 显示所有远程仓库
$ git remote -v
# 显示某个远程仓库的信息
$ git remote show <remote>
# 增加一个新的远程仓库，并命名
$ git remote add <shortname> <url>

# 下载远程仓库的所有变化
$ git fetch [remote]
# 取回远程仓库的变化，并与本地仓库合并
$ git pull [remote] [branch]
# 取回远程仓库的变化，以rebase的方式与本地仓库合并
$ git pull --rebase [remote] [branch]

# 推送本地指定分支的修改到远程仓库
$ git push [remote] [branch]
# 推送本地的修改到gerrit
git push gerrit HEAD:refs/for/<branch>

# 推送所有分支到远程仓库
git push [remote] --all 

分支

# 列出所有本地分支
$ git branch
# 列出所有远程分支
$ git branch -r
# 列出素有本地和远程分支
$ git branch -a

# 新建一个分支，但依然停留在当前分支
$ git branch <branch_name>
# 新建一个分支，并切换到该分支
$ git branch -b <branch_name>
# 新建一个分支，指向特定commit，之前的为HEAD
$ git branch <branch> <commit>
# 新建一个分支，与指定远程分支机建立追踪关系
$ git branch --track <branch_name> <remote_branch>

# 切换到指定分支，并更新工作区
$ git checkout <branch_name>
# 切换到指定commit，并更新工作区，这会使当前Git处于detach HEAD状态
$ git checkout <commit>

# 合并指定分支到当前分支
$ git merge <branch>
# 选择一个commit，合并进当前分支
$ git cherry-pick <commit>

# 删除分支
$ git branch -d <branch_name>
# 删除远程分支
$ git push origin --delet <branch_name>
$ git branch -dr <remote/branch>

# 在现有分支与指定分支远程分支之间建立追踪关系
$ git branch --set-upstream <branch> <remote_branch>

标签

# 列出所有tag
$ git tag
# 查看tag信息
$ git show <tag>

# 新建一个tag在[当前]commit
$ git tag <tag> [commit]

# 提交指定tag 
$ git push [remote] <tag>
# 提交所有tag
$ git push [remote] --tags

# 新建一个分支，指向某个tag
$ git checkout -b <branch_name> <tag>

储藏stash

在某个工作进行到一半，里面的东西处于一个比较杂乱的状态，然后要转到分支进行一些工作，这时候就可以把当前的修改储藏(stash)起来，之后可以返回来提取出来。

# 把当前工作区和暂存区储藏起来
$ git stash
# 把当前工作区和暂存区储藏起来,并指定名字
$ git stash save <stash_name>

# 查看储藏栈
$ git stash list
# 查看某个stash的diff
$ git show [stash]

# 将某个储藏应用到当前工作区
$ git stash apply [stash]
# 将某个储藏应用到工作区和暂存区，和之前一致
$ git stash apply --index [stash]
# 将最新的stash弹出
$ git stash pop
# 将某个stash删除
$ git stash drop <stash>

# 取消某个stash的应用
$ git stash show -p [stash] | git apply -R
# 从储藏中创建分支
$ git stash branch <branch_name> [stash]

补丁

# 生成一个补丁文件
$ git format-patch <first_commit> <second_commit>
# 应用一个补丁文件
$ git apply <patch>