ps:本指南会持续更新

其实一般情况下，只需要掌握git的几个常用命令即可，但是在使用的过程中难免会遇到各种复杂的需求，这时候经常需要搜索，非常麻烦，故总结了一下自己平常会用到的git操作。

git-process

上图所示，使用git的流程一般如此，通常使用图中的六个命令即可。

目录

配置

  1. 下面的命令将修改/home/[username]/.gitconfig文件，也就是说下面的配置只对每一个ssh的用户可见，所以每个人都需要做。

    • 修改提交者的信息

        git config --global user.name [username]
  git config --global user.email [email]

    • 修改git的message编辑器为vim

        git config –global core.editor vim

    • 在git命令中开启颜色显示

        git config --global color.ui true

    • 区分文件名大小写

        编辑.git/config -> core.ignorecase = false或者使用git mv oldFileName newFileName

    • 兼容不同平台的换行符

      For Windows:

        git config --global core.autocrlf true

      For Mac:

        git config --global core.autocrlf input

      同时在ADD之前使用以下命令不再收到关于换行符的提示:

        git config --global core.safecrlf false

    • 如果使用HTTP clone遇到提交大小限制，请使用以下命令提高限值

        git config --global http.postBuffer 524288000(bytes)

    • 此外，也可以使用以下命令做相应修改

        git config -e --global

  2. 下面的命令将修改/etc/gitconfig文件，这是全局配置，所以admin来做一次就可以了。

    配置一些git的常用命令alias

     sudo git config --system alias.st status     #git st
 sudo git config --system alias.ci commit   #git ci
 sudo git config --system alias.co checkout  #git co
 sudo git config --system alias.br  branch  #git br

  3. 也可以进入工作根目录，运行git config -e，这样就只会修改工作区的.git/config文件，但是暂时还用不着.

    git config文件的override顺序是3>1>2.

  4. 显示配置列表

     git config --list

  5. 配置密钥

     ssh-keygen -t rsa -C superhj1987@126.com #生成密钥，把公钥复制到git服务器上
 ssh -T git@github.com #测试是否成功

 #使用ssh-agent管理密码，避免后续需要身份验证的地方需要输入密码
 ssh-add -K private_key_path #添添加私钥到ssh-agent中，使用-K参数将密钥加入到密钥链中
 ssh-add -l  #查看当前计算机中存储的密钥
 ssh-add -d public_key_path #将对应的私钥从ssh-agent删除

取得项目的 Git 仓库

有两种取得 Git 项目仓库的方法。第一种是在现存的目录下，通过导入所有文件来创建新的 Git 仓库。第二种是从已有的 Git 仓库克隆出一个新的镜像仓库来。

  1. 在工作目录中初始化新仓库

    要对现有的某个项目开始用 Git 管理，只需到此项目所在的目录，执行：

     git init 在当前目录新建一个Git代码库
 git init [projectName] 新建一个目录并初始化为Git代码库

  2. 从现有仓库克隆

     git clone git://github.com/superhj1987/test.git

    这会在当前目录下创建一个名为“test”的目录，其中包含一个 .git 的目录，用于保存下载下来的所有版本记录，然后从中取出最新版本的文件拷贝。

记录每次更新到仓库

  1. 检查当前文件状态

     git status

  2. 跟踪新文件、暂存已修改文件

    使用命令git add [dirName] [fileName1] [fileName2](支持正则)开始跟踪一个新文件/文件夹(包括子文件夹)。实际上只是add file into staged area，并没有提交文件。

    此外：

     git add . 添加当前目录的所有文件到暂存区
 git add --a 添加所有文件和目录到暂存区(自己最常用的)

  3. 忽略未纳入版本管理的某些文件/文件夹

    一般我们总会有些文件无需纳入 Git的管理，也不希望它们总出现在未跟踪文件列表。通常都是些自动生成的文件，比如日志文件，或者编译过程中创建的临时文件等。我们可以创建一个名为 .gitignore的文件，列出要忽略的文件模式。

    文件.gitignore 的格式规范如下：

    • 所有空行或者以注释符号 ＃ 开头的行都会被 Git 忽略。
    • 可以使用标准的 glob 模式匹配。 * 匹配模式最后跟反斜杠（/）说明要忽略的是目录。 * 要忽略指定模式以外的文件或目录，可以在模式前加上惊叹号（!）取反。
    • 所谓的 glob 模式是指 shell 所使用的简化了的正则表达式。星号（*）匹配零个或多个任意字符；[abc] 匹配任何一个列在方括号中的字符（这个例子要么匹配一个 a，要么匹配一个 b，要么匹配一个 c）；问号（?）只匹配一个任意字符；如果在方括号中使用短划线分隔两个字符，表示所有在这两个字符范围内的都可以匹配（比如 [0-9] 表示匹配所有 0 到 9 的数字）。

    此外，忽略未纳入版本管理的文件或文件夹的方式还有：

    • 可以为自己配置一个全局的ignore文件，位于任何版本库之外：$ git config –global core.excludesfile ~/.gitignoreglobal
    • .git/info/exclude文件里设置你自己本地需要排除的文件,不会影响到其他人,也不会提交到版本库中去

  4. 忽略已经在版本库里的文件/文件夹

    • 告诉git忽略对已经纳入版本管理的文件a的修改,git会一直忽略此文件直到重新告诉git可以再次跟踪此文件:

        git update-index --assume-unchanged a

    • 告诉git恢复跟踪a

        git update-index -—no-assume-unchanged a

    • 查看当前被忽略的、已经纳入版本库管理的文件

        git ls-files -v | grep -e "^[hsmrck]"

  5. 查看已暂存和未暂存的更新、提交之间的差异

    git status 的显示比较简单，仅仅是列出了修改过的文件，如果要查看具体修改了什么地方，可以用 git diff 命令。

    • git diff #查看尚未暂存的文件更新了哪些部分
    • git diff –cached [file] #看已经暂存起来的文件和上次提交时的快照之间的差异
    • git diff [branch1] [branch2] #显示两次提交之间的差异

  6. 提交更新

    每次准备提交前，先用git status看下，是不是都已暂存起来了，然后再运行提交命令git commit提交更新

    • git commit [file1] [file2] 提交会提示输入本次提交说明
    • git commit -m [messag] 直接附带提交说明
    • git commit –amend#修改最后一次提交
    • git commit -v 提交时显示所有diff信息
    • git commit –amend -m [message] 使用一次新的commit，替代上一次提交,如果代码没有任何新变化，则用来改写上一次commit的提交信息
    • git commit –amend [file1] [file2] … 重做上一次commit，并包括指定文件的新变化

  7. 跳过使用暂存区域

    git commit -a 跳过git add步骤直接commit

  8. 移除文件 要从 Git 中移除某个文件（包括暂存区域和工作目录），就必须要从已跟踪文件清单中移除（确切地说，是从暂存区域移除），然后提交。 可以用 git rm 命令完成此项工作，并连带从工作目录中删除指定的文件，这样以后就不会出现在未跟踪文件清单中了。

      git rm [file1] [file2]

    最后提交的时候，该文件就不再纳入版本管理了。 如果删除之前修改过并且已经放到暂存区域的话，则必须要用强制删除选项 -f（即 force的首字母），以防误删除文件后丢失修改的内容。

    另外一种情况是，我们想把文件从 Git 仓库中删除（亦即从暂存区域移除），但仍然希望保留在当前工作目录中。换句话说，仅是从跟踪清单中删除。比如一些编译文件，不小心纳入仓库后，要移除跟踪但不删除文件，以便稍后在 .gitignore 文件中补上，用 –cached 选项即可：

      git rm --cached [file]

    后面可以列出文件或者目录的名字，也可以使用 glob 模式。比方说：

      git rm log/\*.log

    注意到星号 * 之前的反斜杠 \，因为 Git 有它自己的文件模式扩展匹配方式，所以我们不用 shell 来帮忙展开。实际上不加反斜杠也可以运行，只不过按照shell扩展的话，仅仅删除指定目录下的文件而不会递归匹配。上面的例子本来就指定了目录，所以效果等同，但下面的例子就会用递归方式匹配，所以必须加反斜杠。比如：

      git rm \*~

    会递归删除当前目录及其子目录中所有 ~ 结尾的文件。

  9. 移动文件

    要在 Git 中对文件改名，可以运行如下命令

     git mv file_from file_to

    其实，运行 git mv 就相当于运行了下面三条命令：

     $ mv README.txt README
 $ git rm README.txt
 $ git add README

  10. 回滚文件

    git branch backup // 先备份到一个新分支
git log // 找到要回滚的版本
git reset --hard 版本号 // 回滚

远程仓库的使用

远程仓库是指托管在网络上的项目仓库，可能会有好多个，其中有些你只能读，另外有些可以写。

  1. 查看当前的远程库

    要查看当前配置有哪些远程仓库，可以用 git remote 命令，它会列出每个远程库的简短名字。在克隆完某个项目后，至少可以看到一个名为 origin 的远程库，也可以加上 -v 选项git remote -v，显示对应的克隆地址。

  2. 添加远程仓库

    要添加一个新的远程仓库，可以指定一个简单的名字，以便将来引用，运行 git remote add [shortname] [url]

  3. 从远程同步信息

     git fetch [remote] #下载仓库的所有变动
 git pull [remote] [branch] #取回远程仓库的变化冰河本地分支合并

  4. 推送数据到远程仓库

    项目进行到一个阶段，要同别人分享目前的成果，可以将本地仓库中的数据推送到远程仓库。实现这个任务的命令很简单：

     git push [remote-name] [branch-name]。

    如果要把本地的 master 分支推送到 origin 服务器上（再次说明下，克隆操作会自动使用默认的 master 和 origin 名字），可以运行下面的命令：

     git push origin master

 git push -u origin master //push同时设置默认跟踪分支

    只有在所克隆的服务器上有写权限，或者同一时刻没有其他人在推数据，这条命令才会如期完成任务。如果在你推数据前，已经有其他人推送了若干更新，那你的推送操作就会被驳回。你必须先把他们的更新merge到本地才能继续。

    此外，当你本地的版本落后于远程仓库，但是你想要用旧版本覆盖远程版本的话，使用

     git push --force origin master

    推送所有分支到远程仓库：

     git push [remote] --all

  5. 查看远程仓库信息

    我们可以通过命令 git remote show [remote-name]查看某个远程仓库的详细信息，比如要看所克隆的 origin 仓库，可以运行：

  6. 远程仓库的删除和重命名

    在新版 Git 中可以用 git remote rename 命令修改某个远程仓库在本地的简短名称。使用git remote rm 命令删除远程仓库。

  7. 检出远程仓库的某一分支

     git checkout -b <local.branch> <remote.branch>
 git checkout -t <x

分支的使用

分支是在开发中经常使用的一个功能。

git branch 列出本地分支
git branch -r 列出远端分支
git branch -a 列出所有本地分支和远程分支
git branch -v#查看各个分支最后一个提交对象的信息
git branch --merge#查看已经合并到当前分支的分支
git branch --no-merge#查看为合并到当前分支的分支

git branch [branch-name] 新建分支,但仍然停留在当前分支
git branch [branch] [commit] 新建一个分支，指向指定commit
git branch -m <old_branch_name> <new_branch_name> 重命名分支
git checkout [branch-name] 切换到分支
git checkout -b [branch-name] 新建+切换到该分支
git checkout -b [branch1] [branch2] 基于branch2新建branch1分支，并切换

git branch -d [branch-name] 删除分支
git branch -D [branch-name] 强制删除分支

git merge [branch-name] 将分支合并到当前分支
git rebase [branch-name] 将banch-name分支上超前的提交，变基到当前分支

git branch --set-upstream [branch] [remote-branch] 建立现有分支和指定远程分支的追踪关系

# 删除远程分支
git push origin --delete [branch-name]
git push origin :[branch-name]
git branch -dr [remote/branch-name]

标签的使用

当你完成一个版本的开发，需要做发布的时候，会需要给此次版本打一个表标签：

git tag #列出现有标签

git tag [tag] #新建标签
git tag [tag] #新建一个tag在当前commit
git tag [tag] [commit] #新建一个tag在指定commit
git tag -a [tag] -m 'tag cooment' #新建带注释标签
git checkout -b [branch] [tag] #新建一个分支，指向某个tag

git show [tag] #查看tag信息

git checkout [tagn] #切换到标签

git push [remote] [tag] #推送分支到源上
git push [remote] --tags #一次性推送所有分支

git tag -d [tag] #删除标签
git push origin :refs/tags/v0.1 #删除远程标签

日志

有时候需要查看版本的日志记录，以确定、跟踪代码的变化等

git log #显示当前分支的版本历史
git log --stat #显示commit历史，以及每次commit发生变更的文件，每次提交的文件增删数量

#显示某个文件的版本历史，包括文件改名
git log --follow [file] 
git whatchanged [file]

git blame [file] #显示指定文件由谁何时修改过

git log -p [file] #显示指定文件相关的每一次diff

git show [commit] #显示每次提交的元数据和内容变化
git show --name-only [commit] #显示某次提交发生变化的文件
git show [commit]:[filename] #显示某次提交某个文件的内容

git reflog #显示当前分支的最近几次提交


##下面是git log的高级用法##

git log --oneline #把每一个提交压缩到一行

git log --decorate #显示指向这个提交的所有引用（比如说分支、标签等）
git shortlog #把每个提交按作者分类，显示提交信息的第一行。这样可以容易地看到谁做了什么
git log --graph #绘制一个ASCII图像来展示提交历史的分支结构
git log -<n> #限制显示的提交数量

# 按照现实日期过滤显示结果，日期可以使用多种格式，如2015-1-1, yesterday
git log --after="<date>" #在日期之后
git log --before="<date>" #在日期之前

git log --author="<author>" #按照作者(作者的邮箱地址也算作是作者的名字)

git log --no-merges #排除外来的和并提交
git log --merges #只显示外来合并提交

git log master..feature #从master分支fork到feature分支后发生的变化

git log -- xxx.java #--告诉后面是文件名不是分支名

git log --grep="xxx" #按提交信息来过滤提交
git log <last release> HEAD --grep feature #仅仅显示本次发布新增加的功能。

git log -S "xxx"(-G"<regex>") #根据内容(源代码)来过滤提交
git log --pretty=format:"<string>" #自定义输出格式，占位符：%cn-作者名字 %h-缩略标识 %cd-提价日期
git log <last tag> HEAD --pretty=format:%s #显示上次发布后的变动，每个commit占据一行

撤销

在提交了错误的修改或者想撤销文件的变动时，需要以下命令：

git checkout [file] #恢复暂存区的指定文件到工作区
git checkout [commit] [file] #恢复某个commit的指定文件到工作区
git checkout . #回复上一个commit的所有文件到工作区

git reset --hard #重置暂存区和工作区到上一次commit
git reset [commit] [file] #重置当前分支到commit，重置暂存区，但工作区不变
git reset —soft #只回退commit,此时可以直接git commi
git reset --hard [commit] #重置当前分支的HEAD为指定commit，同时重置暂存区和工作区，与指定commit一致
git reset --keep [commit] #重置当前HEAD为指定commit,但保持暂存区和工作区不变

#新建一个commit撤销指定commit,后者的所有变化都将被前者抵消，并且应用到当前分支
git revert [commit] 
#回退所有内容到上一个版本
git　reset　HEAD^
#回退文件的版本到上一个版本
git　reset　HEAD^　[file]
#向前回退到第3个版本
git　reset　--soft　HEAD~3   

# 清空未进入暂存区的改动
git clean -f -d

选择某些commit操作

git cherry-pick可以选择某一个分支中的一个或几个commit(s)来进行操作。例如，假设我们有个稳定版本的分支，叫v2.0，另外还有个开发版本的分支v3.0，我们不能直接把两个分支合并，这样会导致稳定版本混乱，但是又想增加一个v3.0中的功能到v2.0中，这里就可以使用cherry-pick了。

git cherry-pick <commit id>

解决冲突

在rebase或者merge时，有时候会产生conflicts，如果无法auto merge，那么一般有两种处理方式：

  • 手动修改冲突的文件：修改完成后，使用git add,git commit或者git rebase –continue等后续操作即可。

  • 使用任一方的文件最为最新文件

      git checkout --ours xx
  git checkout --theirs xx

Submodule

当你的工程的部分文件是另一个git库时，可以使用submodule（现在subtree已经替代了submodule）。

  1. 添加

    为当前工程添加submodule，命令如下：

     git submodule add 仓库地址 路径

  2. 删除

    submodule的删除稍微麻烦点：首先，要在“.gitmodules”文件中删除相应配置信息。然后，执行“git rm –cached ”命令将子模块所在的文件从git中删除。

  3. 下载的工程带有submodule

    当使用git clone下来的工程中带有submodule时，初始的时候，submodule的内容并不会自动下载下来的，此时，只需执行如下命令：

     git submodule update --init --recursive

Subtree

  1. 第一次添加子目录，建立与git项目的关联

     git remote add -f <子仓库名> <子仓库地址> #其中-f意思是在添加远程仓库之后，立即执行fetch。
 git subtree add --prefix=<子目录名> <子仓库名> <分支> --squash #–squash意思是把subtree的改动合并成一次commit，这样就不用拉取子项目完整的历史记录。–prefix之后的=等号也可以用空格。

  2. 从远程仓库更新子目录

     git fetch <远程仓库名> <分支>
 git subtree pull --prefix=<子目录名> <远程分支> <分支> --squash

  3. 从子目录push到远程仓库（确认你有写权限）

     git subtree push --prefix=<子目录名> <远程分支名> 分支

其他

git help #获取命令的帮助信息
git archive #生成一个可供发布的压缩包
git rev-list --max-count=1 HEAD #查看当前分支的最新rev
git filter-branch -f --env-filter "GIT_AUTHOR_NAME='Newname'; GIT_AUTHOR_EMAIL='newemail'; GIT_COMMITTER_NAME='Newname'; GIT_COMMITTER_EMAIL='newemail';" HEAD #可以修改历史记录中的作者名字和邮箱
git filter-branch --index-filter 'git rm --cached --ignore-unmatch *.sql' # 删除sql文件的历史记录