learn-git

git-command

摘自 阮一峰:常用 Git 命令清单 略改

一般来说,日常使用只要记住下图6个命令,就可以了。但是熟练使用,恐怕要记住60~100个命令。

Git 命令清单 图:阮一峰

几个专用名词的译名如下,你必须要了解这几个概念

要熟练使用 Git,请记住下面这些命令

  1. 创建新仓库/检出仓库

     # 在当前目录新建一个Git代码库
     $ git init
    
     # 新建一个目录,将其初始化为Git代码库
     $ git init [project-name]
    
     # 下载/检出一个项目和它的整个代码历史
     $ git clone <url>
    
     # depth用于指定克隆深度,为1即表示只克隆最近一次commit
     # 这时会产生一个问题,只会把默认分支clone下来
     $ git clone <url> --depth=1
     $ git clone/fetch <[git clone username@host:]/path/to/repository>
    
     # 增加一个新的远程仓库,并命名
     $ git remote add origin <server>
    
  2. 配置

    参见 ./git-config.md#配置

  3. 添加/删除文件

     # 图解
                  add                 commit
     working dir  <=>  Index(Stage)    <=>    HEAD
     TODO:     rm/checkout            reset
    
     # 添加指定文件到暂存区(临时保存你的改动)
     $ git add [file1] [file2] ...
    
     # 添加指定目录到暂存区,包括子目录
     $ git add [dir]
    
     # 添加当前目录的所有文件到暂存区
     $ git add .
    
     # 添加每个变化前,都会要求确认
     # 对于同一个文件的多处变化,可以实现分次提交
     $ git add -p
    
     # 删除工作区文件,并且将这次删除放入暂存区
     $ git rm [file1] [file2] ...
    
     # 缓存区中删除,停止追踪指定文件,但该文件会保留在工作区
     $ git rm --cached [file]
     $ git rm -r --cached .
    
     # 改名文件,并且将这个改名放入暂存区
     $ git mv [file-original] [file-renamed]
    
  4. 代码提交

    git commit 提交改动到 HEAD,但还没推送到远程(HEAD 指向最后一次提交)

     # 提交暂存区到仓库区
     $ git commit -m [message]
    
     # 提交暂存区的指定文件到仓库区
     $ git commit [file1] [file2] ... -m [message]
    
     # 提交工作区自上次commit之后的变化,直接到仓库区
     $ git commit -a
     $ git commit -am [message]
    
     # 提交时显示所有diff信息
     $ git commit -v
    
     # 使用一次新的commit,替代上一次提交
     # 如果代码没有任何新变化,则用来改写上一次commit的提交信息
     $ git commit --amend -m [message]
    
     # 重做上一次commit,并包括指定文件的新变化
     $ git commit --amend [file1] [file2] ...
    
  5. 远程同步

     # 推送改动
     git push origin <any-branch>
     # 下载远程仓库的所有变动,但是并不合并到当前分支
     $ git fetch [remote]
    
     # 显示所有远程仓库,加 `-v` 可以将地址一起输出
     $ git remote [-v]
    
     # 显示某个远程仓库的信息
     $ git remote show [remote]
    
     # 增加一个新的远程仓库,并命名
     $ git remote add [shortname] [url]
    
     # 删除远程分支
     $ git remote rm origin
     # 如何删除远程关联?
    
     # 取回远程仓库的变化,并与本地分支合并
     $ git pull [remote] [branch]
     $ git pull origin remote:local
     $ git push origin local:remote
     # `git pull` 就是 `git fetch` 和 `git merge` 组成的
    
     # 如果本地分支没和远程关联,每次拉取必须制定分支,也可以使用下面方法关联分支
     $ git branch --set-upstream-to=origin/<branch> master
    
     # 上传本地指定分支到远程仓库
     $ git push [remote] [branch]
    
     # 强行推送当前分支到远程仓库,即使有冲突
     $ git push [remote] --force
    
     # 推送所有分支到远程仓库
     $ git push [remote] --all
    
  6. 分支

     # 列出所有本地分支
     $ git branch | cat
    
     # 列出所有远程分支
     $ git branch -r
    
     # 列出所有本地分支和远程分支
     $ git branch -a
    
     # 新建一个分支,但依然停留在当前分支
     $ git branch [new-branch]
     $ git branch -m <branch-name> <branch-new-name>
    
     # 新建一个分支,并切换到该分支
     $ git checkout -b [new-branch]
     $ git checkout -b develop master
     $ git checkout -b dev origin/dev
    
     # 新建一个分支,指向指定commit
     $ git branch [new-branch] [commit]
    
     # 根据一个特定的提交创建新分支
     $ git branch [new-branch] HEAD^1
    
     # 新建一个分支,与指定的远程分支建立追踪关系
     $ git branch --track [branch] [remote-branch]
    
     # 切换到指定分支,并更新工作区
     $ git checkout [branch-name]
    
     # 切换到上一个分支
     $ git checkout -
    
     # 建立追踪关系,在现有分支与指定的远程分支之间
     $ git branch --set-upstream [branch] [remote-branch]
    
     # 合并指定分支到当前分支(可能出现冲突conflicts,需要手工合并这些冲突)
     $ git merge [branch]
    
     # 选择一个commit,合并进当前分支
     $ git cherry-pick [commit]
    
     # 删除分支
     $ git branch -d [branch-name]
     $ git branch -D hotfix log test
    
     # 删除远程分支
     # gitlab codereview 后,经常删除了远程分支,但本地还存在 remote-tracking
     $ git push origin --delete [remote-branch]
     $ git branch -dr [remote/branch] # 仅仅删除远程跟踪
     $ git remote rm origin # 删除远程分支
     # Deleted remote-tracking branch origin/xxx (was 141f40c).
     # 如何批量删除跟踪?
    
  7. 标签

     # 列出所有tag
     $ git tag
    
     # 新建一个tag在当前commit
     $ git tag [tag]
    
     # 新建一个tag在指定commit
     $ git tag [tag] [commit]
    
     # 删除本地tag
     $ git tag -d [tag]
    
     # 删除远程tag
     $ git push origin :refs/tags/[tagName]
    
     # 查看tag信息
     $ git show [tag]
    
     # 提交指定tag
     $ git push [remote] [tag]
    
     # 提交所有tag
     $ git push [remote] --tags
    
     # 新建一个分支,指向某个tag
     $ git checkout -b [new-branch] [tag]
    
     # 切换到某个特定的 tag
     $ git checkout [tag]
    
     # 切换到某个特定的分支,但是分支名和标签名重叠了
     $ git checkout [tags/v1.x]
    
     # 扩展
     # 先列出按照时间倒叙的 tag 列表,然后取出第一行
     $ git tag -n --sort=-taggerdate | grep n1
    
     # 利用 git log 的 format 取出 hash
     $ git log --format="%h" ${lastTag} |grep n1
    
     # 回滚
     $ get reset --hard ${lastTagHash}
    
  8. 撤销

     # 恢复暂存区的指定文件到工作区
     # 此命令会使用 HEAD 中的最新内容替换掉你的工作目录中的文件,
     # 已添加到暂存区的改动以及新文件都不会受到影响
     $ git checkout [file]
    
     # 恢复某个commit的指定文件到暂存区和工作区
     $ git checkout [commit] [file]
    
     # 恢复暂存区的所有文件到工作区
     $ git checkout .
    
     # 重置暂存区的指定文件,与上一次commit保持一致,但工作区不变
     $ git reset [file]
    
     # 重置暂存区与工作区,与上一次commit保持一致
     $ git reset --hard
    
     # 重置当前分支的指针为指定commit,同时重置暂存区,但工作区不变
     $ git reset [commit]
    
     # 假如你想丢弃你在本地的所有改动与提交,可以到服务器上获取最新的版本历史,并将你本地主分支指向它
     $ git fetch origin
     $ git reset --hard origin/master
    
     # 重置当前分支的HEAD为指定commit,同时重置暂存区和工作区,与指定commit一致
     $ git reset --hard [commit]
    
     # 重置当前HEAD为指定commit,但保持暂存区和工作区不变
     $ git reset --keep [commit]
    
     # 新建一个commit,用来撤销指定commit(针对已经 push到远程,无法本地使用 reset修复的情况)
     # revert 是使用一个反向 commit 来抵消之前 commit 作出的修改而不是将之前的 commit 删除
     $ git revert [bad-commit]
     # https://github.com/geeeeeeeeek/git-recipes/wiki/5.2-%E4%BB%A3%E7%A0%81%E5%9B%9E%E6%BB%9A%EF%BC%9AReset%E3%80%81Checkout%E3%80%81Revert-%E7%9A%84%E9%80%89%E6%8B%A9
    
     # 暂时将未提交的变化移除,稍后再移入
     $ git stash
     $ git stash list
     $ git stash pop
     $ git stash clear
    
  9. 查看信息

     # 显示有变更的文件
     $ git status
    
     # 显示有变更的文件 也显示忽略的文件
     $ git status --ignored
    
     # 显示当前分支的版本历史
     $ git log
    
     # 显示commit历史,以及每次commit发生变更的文件
     $ git log --stat
    
     # 搜索提交历史,根据关键词
     $ git log -S [keyword]
    
     # 只看某一个人的提交记录
     $ git log --auth=bob
    
     # 显示某个commit之后的所有变动,每个commit占据一行
     $ git log [tag] HEAD --pretty=format:%s
    
     # 显示某个commit之后的所有变动,其"提交说明"必须符合搜索条件
     $ git log [tag] HEAD --grep feature
    
     # 一个压缩后的每一条提交记录只占一行的输出
     $ git log --pretty=online
    
     # 树形结构展示所有分支,包含作者和标签
     $ git log --graph --oneline --decorate --all
    
     # 显示过去5次提交
     $ git log -5 --pretty --oneline
    
     # 显示某个文件的版本历史,包括文件改名
     $ git log --follow [file]
     $ git whatchanged [file]
    
     # 显示指定文件相关的每一次diff
     $ git log -p [file]
    
     # 看看哪些文件改变了
     $ git log --name-status
    
     # 显示所有提交过的用户,按提交次数排序
     $ git shortlog -sn
    
     # 显示指定文件是什么人在什么时间修改过
     $ git blame [file]
    
     # 显示暂存区和工作区的差异
     $ git diff
    
     # 显示暂存区和上一个commit的(本地库)差异
     $ git diff --cached [file]
    
     # 显示工作区与当前分支最新commit之间的差异
     $ git diff HEAD
    
     # 显示任意两个 commit 之间的差异
     $ git diff [commit-id] [commit-id]
    
     # 显示今天你写了多少行代码
     $ git diff --shortstat "@{0 day ago}"
    
     # 显示某次提交的元数据和内容变化
     $ git show [commit]
    
     # 显示某次提交发生变化的文件
     $ git show --name-only [commit]
    
     # 显示某次提交时,某个文件的内容
     $ git show [commit]:[filename]
    
     # 显示当前分支的最近几次提交
     $ git reflog
    
  10. 其他

    Golden Rule of Rebasing 永远不要在public 分支上使用git rebase!

    # Squash 多个commit,在发起 PR 之前,应该把多个 commit 合并成一个(前提是该分支只有你一个人开发,且没有根 master 合并过)
    
    # 合并多次提交纪录(commit 次数太多,不利于 Code Review,不利于排查问题)
    $ git rebase -i HEAD~4
    $ git rebase -i <commit hash>
    
    # 分支 branch-2 合并到 branch-1
    git rebase [branch-1] [branch-2]
    
    # 合并一段 commits
    $ git rebase --onto [base-branch] [from-branch] [to-branch]
    # 用于修正在错误点拉出分支并 committed 代码的问题
    # git rebase --onto master wrong_branch readme-update
    
    # `--abort` 参数终止 rebase
    $ git rebase --abort
    
    # 统计出文件中还有多少个 TODO 字符串
    $ git grep --count TODO
    
    # 生成一个可供发布的压缩包
    $ git archive
    
    # 实用小贴士
    # 内建的图形化 git
    $ gitk
    # 彩色的 git 输出
    $ git config color.ui true
    # 显示历史记录时,每个提交的信息只显示一行
    $ git config format.pretty oneline
    # 交互式添加文件到暂存区
    $ git add -i
    

用的多了就熟练了,Git命令行确实很简单而且功能十分强悍!建议多用用命令行模式。

进阶

关于撤销

git-status

git-file-flow

reset soft

关于 HEAD^HEAD~

首先,Git 提交可以有多个父级,使用 ^ 你可以找到任何提交的父级,而不仅仅是HEAD。你也可以追溯到几代人,使用 ~

为了有一个直观的表示,让我们引用文档的一部分:

以下是Jon Loeliger的插图。 提交节点B和C都是提交节点A的父节点。父提交从左到右排序。

G   H   I   J
 \ /     \ /
  D   E   F
   \  |  / \
    \ | /   |
     \|/    |
      B     C
       \   /
        \ /
         A

A =      = A^0
B = A^   = A^1     = A~1
C = A^2  = A^2
D = A^^  = A^1^1   = A~2
E = B^2  = A^^2
F = B^3  = A^^3
G = A^^^ = A^1^1^1 = A~3
H = D^2  = B^^2    = A^^^2  = A~2^2
I = F^   = B^3^    = A^^3^
J = F^2  = B^3^2   = A^^3^2

参考: