Git Introduction

环境配置

• 初始化配置
  

  git init                                # 初始化仓库
  git init --separate-git-dir <gitdir>    # 初始化分离仓库
  git config [--global] user.name "Micky Ching"
  git config [--global] user.email "mickyching@gmail.com"
  

  separate-git-dir

  对于重要项目，我个人比较喜欢用分离仓库，这样可以较好的防止对代码批处理时错误的修改仓库数据库。

  global

  使用该选项会将配置信息写入用户配置文件中，不使用则将配置信息写入当前仓库配置文件中。

  user.name

  由于提交需要提交者信息，所以配置用户名和邮箱是很有必要的。

  另外往往需要配置哪些文件需要忽略，这通过.gitignore文件来记录要忽略的文件或规则。

• 提交代码
  

  仓库一旦初始化就可以添加文件并提交了，更高级的可以选择添加一个diff区或一行修改等等。

  git add <files>                         # 添加文件/文件夹
  git add -i                              # 交互式添加文件
  git commit                              # 提交，启动编辑器编辑提交信息
  git commit -m <message>                 # 提交，直接写入提交信息
  git commit --amend                      # 提交，修改上一次提交
  

  仓库中的文件有三种状态，其转换关系如下图所示：

  

  在首次提交前，添加了错误文件时，由于没有HEAD，不能使用git reset HEAD撤销，此时可以使用如下命令来撤销添加。

  git rm -r --cached <files>              # 撤销add添加的文件
  

• 信息查看
  

  git status                              # 查看项目状态
  git log                                 # 查看日志
  git diff <commit>                       # 查看相对于指定提交的更改
  git ls-files                            # 查看当前目录下被跟踪的文件
  git ls-tree -r HEAD                     # 查看当前目录下被跟踪的文件
  # 查看所有被跟踪过的文件，包括已经被删除的文件
  git log --pretty=format: --name-only --diff-filter=A | sort - | sed '/^$/d'
  

  对于日志显示，通常需要在配置文件中指定显示格式，以便阅读，需要注意的是--graph选项可能会影响速度，尤其对于大型仓库。我定义了如下两个alias命令来查看日志：

  ll = log --pretty=format:'%Cred%ad %h%Cgreen%d%<|(100,trunc) %Creset%s %C(cyan)%an <%ae>'\
     --color=auto --date=short --abbrev-commit
  lg = log --pretty=format:'%Cred%ad %h%Cgreen%d%<|(100,trunc) %Creset%s %C(cyan)%an <%ae>'\
     --color=auto --date=short --abbrev-commit --graph
  

  下图展示了用于查看不同节点间差异的方法。

  

远程管理

• 远程配置
  

  创建ssh密钥以避免每次上传下载都要输入密码：

  ssh-keygen -t rsa -C "mickyching@gmail.com" -f ~/.ssh/micky-gmail
  ssh-add ~/.ssh/micky-gmail                    # 添加密钥
  ssh -i ~/.ssh/micky-gmail -T git@github.com   # 验证测试
  

  如果不添加密钥，可能会出现如下错误提示：

  Agent admitted failure to sign using the key
  

  如果要配置多个远程仓库帐号，需要编辑配置文件~/.ssh/config指定登录信息。

  Host github                             # 主机名，可任意命名
      HostName github.com                 # 登录地址
      User git
      Port 22
      IdentityFile ~/.ssh/micky-gmail     # 证书路径
  

  最后在远程服务器上设置好公钥，就可以无需输入密码实现上传和下载了。

• 远程操作
  

  git remote add <repo-name> <repo-url>   # 添加远程仓库地址
  git remote -v                           # 查看远程仓库地址
  git remote set-url <repo-name> <url>    # 更改仓库地址
  git pull <repo-name> <branch>           # 拉取远程仓库分支到当前分支
  git fetch <repo-name>                   # 下载远程仓库
  git fetch <repo-name> <a>:<b>           # 将远程分支a下载为分支b
  git push <repo-name> <branch>           # 将当前分支发送到远程分支
  git push <repo-name> <a>:<b>            # 将分支a发送到远程分支b
  git push <repo-name> :<b>               # 删除远程分支
  git push --tags                         # 推送tag
  git remote set-head origin --auto       # 可用于修复remote/HEAD失效
  

分支管理

• 分支管理
  

  git branch [-vv]                        # 查看分支，冗余模式能显示跟踪对象
  git branch <branchname>                 # 创建分支
  git branch -d <branchname>              # 删除已合并的分支
  git branch -D <branchname>              # 强制删除分支
  git branch -dr <remote/branch>          # 删除本地下载的远程分支
  git remote prune <remote>               # 删除远程已经不存在的跟踪分支
  git checkout <branchname>               # 切换分支
  git checkout <commit> -- <filename>     # 检出指定文件
  git rebase <branch-b>                   # 基于指定分支: ours=branch-b
  git merge <branch-b>                    # 合并指定分支: ours=branch-a
  git reset <commit>                      # 复位到指定提交
  git revert <commit>                     # 反转提交
  

  通常来说，创建一个分支往往是为了单独实现一个较大的功能，在实现完成之后再合并到主分支。 rebase和merge的区别在于rebase之后只有一条主线，而merge之后仍然保留多条主线，只不过最后将其汇合为一点。仓库管理的基本原则是merge越少越好，所以提交之前需要在本地做好rebase再推送，因为当你打算推送的时候，远程可能已经被别人修改了，此时最佳策略就是将本地rebase到远程最新提交点再提交。

  同样的道理，用reset的方法废除一个提交不会在仓库中留下痕迹，但是revert实际上保存了两个提交。原则上仓库中revert越少越好，所以如果一个提交有问题，需要彻底废除，在未推送到远程之前，最佳做法是通过reset将其废除，如果已经推送，那么只能通过revert来废除原来的提交。

  其实对于提交也需要同样注意，尽量做到每个提交都很好的完成一个提交的任务，如果代码改动很大，就要做成多个独立的提交。简单的说，每个提交要保证其正确性、可用性、可读性，不要滥用提交。

• 标签管理
  

  git tag <v0.1>                          # 添加tag
  git tag                                 # 列举tag
  

错误追踪

git blame <filename>                    # 查看每一行在何时引入
git blame -L n,m <filename>             # 查看文件指定行何时引入

git bisect start [<bad> <good>]         # 开始二分查找
git bisect reset                        # 结束二分查找，回到开始前的位置
git bisect good [<commit>]              # 标记当前为good
git bisect bad [<commit>]               # 标记当前为bad
git checkout bisect/bad                 # 切换到最终定位的bad
git bisect log                          # 查看二分日志，可以用重定向保存
git bisect replay <file.log>            # 从二分日志恢复进度
git bisect HEAD1 HEAD2                  # 标记查询区间

实用操作

• 暂存管理
  

  git stash                               # 添加当前修改到暂存区
  git stash list                          # 列举暂存区
  git stash pop                           # 弹出暂存区
  

• 仓库清理
  

  git clean -ndx                          # 显示要删除的文件列表
  git clean -fdx                          # 删除仓库之外的文件
  git gc                                  # 垃圾清理，建议少用
  

  所有的清理动作都应该慎重。

• 选取提交
  

  git cherry-pick <commit>                # 选取指定提交放到当前位置
  

• 仓库打包
  

  git archive --prefix="emacs/" -o emacs.zip HEAD
  git archive -o emacs-partial.tar HEAD lisp/ site-lisp/
  git archive --format=tar --prefix="emacsd/" master | gzip > emacsd.tar.gz