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文件的历史记录