git 常用命令清单

这个清单是基于常用 Git 命令清单 - 阮一峰的博客修改的，
加上了安装配置部分和一些例子，并补充了一些命令（不断更新）。

常用 Git 命令清单

我每天使用 Git ，但是很多命令记不住。
　　一般来说，日常使用只要记住下图6个命令，就可以了。但是熟练使用，恐怕要记住60～100个命令。

下面是我整理的常用 Git 命令清单。几个专用名词的译名如下。
Workspace：工作区
Index / Stage：暂存区
Repository：仓库区（或本地仓库）
Remote：远程仓库

安装配置 - niko

ssh key 简要流程

• ssh-keygen -t rsa -C "foo@gmail.com"，选择生成位置（~/.ssh/foo_rsa）。
• ssh-agent -s
  若提示 Could not open a connection to your authentication agent., 使用：
  eval ssh-agent -s
• ssh-add ~/.ssh/foo_rsa
• clip < ~/.ssh/foo_rsa.pub
• 添加到远程服务器的ssh_keys；
• git clone ...

记得 .ssh 相关文件须是 600 权限 .

设置ssh配置

vim ~/.ssh/config

Host dev
    HostName dev.example.com
    Port 22000
    User fooey</p>
Host github.com
    IdentityFile ~/.ssh/github.key
Host oschina.net
    IdentityFile ~/.ssh/id_rsa_osc
Host github.com
    IdentityFile ~/.ssh/id_rsa_github

http://nerderati.com/2011/03/17/simplify-your-life-with-an-ssh-config-file/

一、新建代码库

• 在当前目录新建一个Git代码库
  $ git init

• 新建一个目录，将其初始化为Git代码库
  $ git init [project-name]

• 下载一个项目和它的整个代码历史
  $ git clone [url]

• clone 某个分支
  git clone -b <remote_repo>

二、git 配置

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

• 显示当前的Git配置
  $ git config --list

• 编辑Git配置文件
  $ git config -e [--global]

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

• push pull 策略

ref ： http://blog.angular.in/git-pushmo-ren-fen-zhi/

push.default 未设置：

warning: push.default is unset; its implicit value is changing in
Git 2.0 from 'matching' to 'simple'. To squelch this message
and maintain the current behavior after the default changes, use:

  git config --global push.default matching

To squelch this message and adopt the new behavior now, use:

  git config --global push.default simple

When push.default is set to 'matching', git will push local branches
to the remote branches that already exist with the same name.

In Git 2.0, Git will default to the more conservative 'simple'
behavior, which only pushes the current branch to the corresponding
remote branch that 'git pull' uses to update the current branch.

See 'git help config' and search for 'push.default' for further information.
(the 'simple' mode was introduced in Git 1.7.11. Use the similar mode
'current' instead of 'simple' if you sometimes use older versions of Git)

git config --global push.default 'option'

option：

nothing - push操作无效，除非显式指定远程分支，例如git push origin develop（我觉得。。。可以给那些不愿学git的同事配上此项）。

current - push当前分支到远程同名分支，如果远程同名分支不存在则自动创建同名分支。

upstream - push当前分支到它的upstream分支上（这一项其实用于经常从本地分支push/pull到同一远程仓库的情景，这种模式叫做central workflow）。

simple - simple和upstream是相似的，只有一点不同，simple必须保证本地分支和它的远程 upstream分支同名，否则会拒绝push操作。

matching - push所有本地和远程两端都存在的同名分支。

三、增加/删除文件

• 添加指定文件到暂存区
  $ git add [file1] [file2] ...

• 添加指定目录到暂存区，包括子目录
  $ git add [dir]

• 添加当前目录的所有文件到暂存区
  git add .
  git add --all (对删除文件有效)

• 取消放入暂存区 (undo add)
  git reset foo_file
  git reset HEAD foo_file
  git reset

• 删除工作区文件，并且将这次删除放入暂存区
  git rm [file1] [file2] ...

• 停止追踪指定文件，但该文件会保留在工作区
  git rm --cached [file]

• 改名文件，并且将这个改名放入暂存区
  git mv [file-original] [file-renamed]

• 取消改名
  git mv [file-renamed] [file-original]

四、代码提交

---

• 提交暂存区到仓库区
  git commit -m [message]

• 提交暂存区的指定文件到仓库区
  git commit [file1] [file2] ... -m [message]

• 提交工作区自上次commit之后的变化，直接到仓库区
  git commit -a

• 提交时显示所有diff信息
  git commit -v

• 使用一次新的commit，替代上一次提交

• 重做上一次commit，并包括指定文件的新变化
• 如果代码没有任何新变化，则用来改写上一次commit的提交信息
  $ git commit --amend -m [message]
  $ git commit --amend ...

五、分支

• 列出所有本地分支
  $ git branch

• 列出所有远程分支
  $ git branch -r

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

• 新建一个分支，但依然停留在当前分支
  $ git branch [branch-name]

• 新建一个分支，并切换到该分支
  $ git checkout -b [branch]

• 新建一个分支，指向指定commit
  $ git branch [branch] [commit]

• 新建一个分支，与指定的远程分支建立追踪关系
  $ git branch --track [branch] [remote-branch]

• 切换到指定分支，并更新工作区
  $ git checkout [branch-name]

• checkout remote 分支
  git checkout -b test /test
  https://stackoverflow.com/questions/1783405/how-do-i-check-out-a-remote-git-branch

• 建立追踪关系，在现有分支与指定的远程分支之间
  $ git branch --set-upstream [branch] [remote-branch]

• 合并指定分支到当前分支
  $ git merge [branch]

• 选择一个commit，合并进当前分支
  $ git cherry-pick [commit]

• 终止(abort) merge 操作：
  $ git reset --hard HEAD
  http://stackoverflow.com/questions/101752/i-ran-into-a-merge-conflict-how-can-i-abort-the-merge

• 删除分支
  $ git branch -d [branch-name]

• 删除远程分支
  git push origin --delete
  git push origin --delete
  git branch -dr

六、标签

• 列出所有tag
  $ git tag

• 新建一个tag在当前commit
  git tag [tag]

• 注释：
  git tag -a v1.4 -m 'my version 1.4'

• 新建一个tag在指定commit
  $ git tag [tag] [commit]

• 查看tag信息
  $ git show [tag]

• 提交指定tag
  $ git push [remote] [tag]

• 提交所有tag
  $ git push [remote] --tags

• 新建一个分支，指向某个tag
  $ git checkout -b [branch] [tag]

• 删除本地 tag
  git tag -d [tag]

• 删除远程 tag (和 branch 的操作一样)
  git push --delete origin [tag]

七、查看信息

• 显示有变更的文件
  $ git status

• GUI 审查代码
  git difftool

• 显示当前分支的版本历史
  $ git log

• 显示commit历史，以及每次commit发生变更的文件
  $ git log --stat

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

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

• 华丽的分支log
  git log --graph --decorate --pretty=oneline --abbrev-commit develop origin/develop temp-branch

• 显示指定文件是什么人在什么时间修改过
  git blame [file]

• 显示暂存区和工作区的差异
  git diff

• 显示暂存区和上一个commit的差异
  git diff --cached []

• 显示工作区与当前分支最新commit之间的差异
  git diff HEAD

• 显示两次提交之间的差异
  git diff [first-branch]...[second-branch]

查看合并的两个分支, 方法参考这里

git log
commit 0e1329e551a5700614a2a34d8101e92fd9f2cad6 (HEAD, master)
Merge: fc17405 ee2de56
Author: Tilman Vogel <email@email>
Date:   Tue Feb 22 00:27:17 2011 +0100

Merge branch 'testing' into master

# 关注这里
Merge: fc17405 ee2de56

#
git diff ee2de56..fc17405
git diff --name-only ee2de56..fc17405

• 显示某次提交的元数据和内容变化
  $ git show [commit]

• 显示某次提交发生变化的文件
  $ git show --name-only [commit]

• 显示某次提交时，某个文件的内容
  $ git show [commit]:[filename]

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

  Reference logs, or "reflogs", record when the tips of branches and other references were updated in the local repository. Reflogs are useful in various Git commands, to specify the old value of a reference.

reflog可以看到被删除的记录(如)，而git log不能。

八、远程同步

• 下载远程仓库的所有变动
  $ git fetch [remote]

Download objects and refs from another repository
用"git fetch"" 来执行"git pull"前半部分的工作， 但是这条命令并不会把抓下来的修改合并到当前分支里。

• 显示所有远程仓库
  $ git remote -v

• 显示某个远程仓库的信息
  $ git remote show [remote]

• 增加一个新的远程仓库，并命名
  $ git remote add [shortname] [url]

• 取回远程仓库的变化，并与本地分支合并
  $ git pull [remote] [branch]

• 上传本地指定分支到远程仓库
  $ git push [remote] [branch]

• 推送本地指定的分支名到远程仓库 - niko
  $ git push origin develop:develop_remote
  $ git push :

• 强行推送当前分支到远程仓库，即使有冲突
  $ git push [remote] --force

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

• with rebase
  git pull --rebase

• 查看 git 管理下的文件(In the Index and the Working Tree)
  git ls-file

九、撤销

• 恢复暂存区的指定文件到工作区
  $ git checkout [file]

• 恢复某个commit的指定文件到工作区
  $ git checkout [commit] [file]

• 恢复上一个commit的所有文件到工作区
  $ git checkout .

• 取消commit
  $ git reset --soft HEAD~

• 重置暂存区的指定文件，与上一次commit保持一致，但工作区不变
  $ git reset [file]
  REF: http://stackoverflow.com/questions/927358/how-do-you-undo-the-last-commit

• 重置暂存区与工作区，与上一次commit保持一致
  $ git reset --hard

• 重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变
  $ git reset [commit]

• 重置当前分支的HEAD为指定commit，同时重置暂存区和工作区，与指定commit一致
  $ git reset --hard [commit]

• 重置当前HEAD为指定commit，但保持暂存区和工作区不变
  $ git reset --keep [commit]

• undo reset
  git reflog
  git reset HEAD@{1}
  undo reset

• 新建一个commit，用来撤销指定commit

• 后者的所有变化都将被前者抵消，并且应用到当前分支
  $ git revert [commit]

• 恢复删除的分支
  // TODO
  http://stackoverflow.com/questions/16793637/recover-deleted-branch-git
  https://confluence.atlassian.com/bbkb/how-to-restore-a-deleted-branch-765757540.html

• TODO rebase
  If you prefer to skip this patch,
  https://help.github.com/articles/resolving-merge-conflicts-after-a-git-rebase/

十、其他

• 生成一个可供发布的压缩包
  git archive
  via：ruanyifeng.com

-
git rebase
使分支历史看起来像没有经过合并一样。

• 分支上一次合并的信息 - niko
  git show --summary git merge-base A B

参考资料

---