git命令详解
- 注意:比如
git checkout -- <filename>
,事实上很多时候我们使用git checkout <filename>
也不会有问题。那么--
到底是用来做什么的呢?
-
--
代表后面的参数是命令(和参数间不存在空格),如果没有--
,一般指分支或者路径。主要是用来区分文件目录和命令的关系
- 对于一些命令来说,作为参数传入文件路径和直接操作路径都是相同的
# “-- ”(注意和参数间存在空格)把后面连接的参数当做文件名,不管它长什么样子。它是unix的命令行规范。通常,我们使用“--”去区分后面的是一个命令还是一个参数。比如下面例子:
$ rm -f # does nothing
$ rm -- -f # deletes a file named "-f"
# 一般我们通过使用它来区分文件名和命令参数,如果一个文件名刚好和我们常用的命令冲突了,-- 就可以很好的解决这个问题。通常都会加上“--”来区分使用
新建代码库(初始化)
# 在当前目录新建一个Git代码库
# git默认为我们创建的分支名叫 master
$ git init
# Git支持本地协议,所以我们可以初始化一个本地的远程服务器
# 新建一个目录,将其初始化为Git代码库
$ git init [project-name]
# 下载一个项目和它的整个代码历史
# 克隆一个远程仓库作为本地仓库
$ git clone [url]
配置
- Git的设置文件为
.gitconfig
,它可以在用户主目录下(全局配置),也可以在项目目录下(项目配置)
# 显示当前的Git配置
$ git config --list
# 编辑Git配置文件
$ git config -e [--global]
# 设置提交代码时的用户信息
$ git config [--global] user.name "[name]"
$ git config [--global] user.email "[email address]"
# alias命令:用于给命名设置别名
$ git config alias.shortname <fullcommand>
# 比如
$ git config --global alias.lg "log --color --graph --pretty==format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(boldblue)<%an>%reset' --abbrev-commit"
# 配置之后就可以直接使用 $ git lg 来查看信息
$ git lg
- 配置级别
- local(默认,高优先级):只影响本仓库
- global(中优先级):影响到所有当前用户的git仓库
- system(低优先级):影响到全系统的git仓库
添加删除文件
# 添加指定文件到暂存区
$ git add [file1] [file2] ...
# 添加指定目录到暂存区,包括子目录(同时文件被跟踪)
$ git add [dir]
# 添加当前目录的所有文件到暂存区
$ git add .
# 添加每个变化前,都会要求确认
# 对于同一个文件的多处变化,可以实现分次提交
$ git add -p
# 删除工作区文件,并且将这次删除放入暂存区
# 从暂存区与工作目录删除
$ git rm [file1] [file2] ...
# 停止追踪指定文件,但该文件会保留在工作区
# 仅从暂存区删除
$ git rm --cached [file]
# 删除所有被跟踪,但是在工作目录被删除的文件
$ git rm $(git ls-fils --deleted)
# 改名文件,并且将这个改名放入暂存区
$ git mv [file-original] [file-renamed]
代码提交
# 并不是只要使用git commit可以提交我们的代码与其它开发者共享
# 提交暂存区到仓库区,每次提交必须留点信息出来,加点备注,方便以后查询提交记录,所以 git 强制要求加这个参数,哪怕是空字符串
$ git commit -m [message]
# 提交暂存区的指定文件到仓库区
$ git commit [file1] [file2] ... -m [message]
# 将工作区自上次commit之后的变化,直接提交到仓库区
$ git commit -a
# 提交时显示所有diff信息
$ git commit -v
# 使用一次新的commit,替代上一次提交
# 如果代码没有任何新变化,则用来改写上一次commit的提交信息
$ git commit --amend -m [message]
# 重做上一次commit,并包括指定文件的新变化
$ git commit --amend [file1] [file2] ...
分支
# 列出所有本地分支。分支的增删查改都靠它
$ git branch
# 列出所有远程分支
$ git branch -r
# 列出所有本地分支和远程分支
$ git branch -a
# 新建一个分支,但依然停留在当前分支
$ git branch [branch-name]
# 删除分支
$ git branch -d [branch-name]
# 查看各个分支最后一个提交对象的信息(显示所有的分支信息)
$ git branch -v
# 删除远程分支
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]
# 新建一个分支,并切换到该分支
$ git checkout -b [branch]
# 新建一个分支,指向指定commit
$ git branch [branch] [commit]
# 新建一个分支,与指定的远程分支建立追踪关系
$ git branch --track [branch] [remote-branch]
# 切换到指定分支,并更新工作区
$ git checkout [branch-name]
# 假如HEAD当前指向master分支,下面三种方式与 git checkout HEAD~2 的效果是一样
$ git checkout HEAD^^
$ git checkout HEAD^~1
$ git checkout master~2
# A^:A上的父提交。A~n:在A之前的第n次提交
# 切换到上一个分支
$ git checkout -
# 建立追踪关系,在现有分支与指定的远程分支之间
$ git branch --set-upstream [branch] [remote-branch]
# 合并指定分支到当前分支
$ git merge [branch]
# 选择一个commit,合并进当前分支
$ git cherry-pick [commit]
# 将master分支上超前的提交,变基到当前分支
# 不要再共有分支上使用rebase
$ git rebase master
# 限制回滚范围,rebase当前分支从169a6以后的提交
$ git rebase --onto master 169a6
标签
# 列出所有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 [branch] [tag]
查看信息
# 显示有变更的文件
$ git status
# 显示当前分支的版本历史
# 可以帮助我们获得的信息有:提交作者、提交信息、标识提交的hash值
$ git log
# 显示commit历史,以及每次commit发生变更的文件
$ git log --stat
# 搜索提交历史,根据关键词
$ git log -S [keyword]
# 显示某个commit之后的所有变动,每个commit占据一行
$ git log [tag] HEAD --pretty=format:%s
# 显示某个commit之后的所有变动,其"提交说明"必须符合搜索条件
$ git log [tag] HEAD --grep feature
# 显示某个文件的版本历史,包括文件改名
$ git log --follow [file]
$ git whatchanged [file]
# 显示指定文件相关的每一次diff
$ git log -p [file]
# 显示过去5次提交
$ git log -5 --pretty --oneline
# 显示所有提交过的用户,按提交次数排序
$ git shortlog -sn
# 显示指定文件是什么人在什么时间修改过
$ git blame [file]
# 显示暂存区和工作区的差异
$ git diff
# 显示暂存区与某次提交的的差异,默认为 HEAD
$ git diff --cached [file]
# 显示工作区与当前分支最新commit之间的差异
$ git diff HEAD
# 工作目录与某次提交的差异
$ git diff <reference>
# 显示两次提交之间的差异
$ git diff [first-branch]...[second-branch]
# 显示今天你写了多少行代码
$ git diff --shortstat "@{0 day ago}"
# 显示某次提交的元数据和内容变化
$ git show [commit]
# 显示某次提交发生变化的文件
$ git show --name-only [commit]
# 显示某次提交时,某个文件的内容
$ git show [commit]:[filename]
# 显示当前分支的最近几次提交
$ git reflog
远程同步
# 下载远程仓库的所有变动
$ git fetch [remote]
# 显示所有远程仓库的信息
$ git remote -v
# 显示某个远程仓库的信息
$ git remote show [remote]
# 增加一个新的远程仓库,并命名(远程仓库别名)
$ git remote add [shortname] [url]
# 取回远程仓库的变化,并与本地分支合并
$ git pull [remote] [branch]
# 上传本地指定分支到远程仓库
$ git push [remote] [branch]
# 强行推送当前分支到远程仓库,即使有冲突
$ git push [remote] --force
# 推送所有分支到远程仓库
$ git push [remote] --all
-
为何使用git fetch来分步骤处理要优于直接使用git pull(git pull = git fetch + git merge)?
- git pull的问题是它把过程的细节都隐藏了起来,以至于我们不用去了解git中各种类型分支的区别和使用方法。当然,多数时候这是没问题的,但一旦代码有问题,我们很难找到出错的地方
- 将下载(fetch)和合并(merge)放到一个命令里的另外一个弊端是,我们的本地工作目录在未经确认的情况下就会被远程分支更新。当然,除非我们关闭所有的安全选项,否则git pull在本地工作目录还不至于造成不可挽回的损失,但很多时候我们宁愿做的慢一些,也不愿意返工重来
- 前面那些行显示出“git fetch”命令会将哪些文件下载到本地,这些文件一旦下载到本地之后,就可以在本地进行任意操作了
- “git fetch”命令执行完毕之后,还不会立即将下载的文件合并到我们当前工作目录里,这就给了一个选择下一步操作的机会,要是想将从远程分支下载的文件更新到我们的工作目录里,只需要执行一个“合并(merge)”操作
- 单独进行下载和合并是一个好的做法,我们可以先看看下载的是什么,然后再决定是否和本地代码合并。而且分开来做,可以清晰的区别开本地分支和远程分支,方便选择使用
撤销
# 恢复暂存区的指定文件到工作区(切换到file分支)
$ git checkout [file]
# 恢复某个commit的指定文件到暂存区和工作区
$ git checkout [commit] [file]
# 恢复暂存区的所有文件到工作区
$ git checkout .
# 重置暂存区的指定文件,与上一次commit保持一致,但工作区不变
$ git reset [file]
# 将文件内容从上次提交复制到暂存区
$ git reset HEAD <file>
# 将文件内容从上次提交复制到工作目录
$ git reset HEAD -- <file>
# 当某文件在暂存区与工作目录的内容不一致时, 使用 git checkout HEAD -- <filename> 将导致工作目录被上次提交的覆盖,这时候暂存区也就没有修改了,clean掉了。其实就是本地和暂存区都被上一次的提交覆盖了
# 重置暂存区与工作区,与上一次commit保持一致
$ git reset --hard
# 重置当前分支的指针为指定commit,同时重置暂存区,但工作区不变
$ git reset [commit]
# 重置当前分支的HEAD为指定commit,同时重置暂存区和工作区,与指定commit一致
$ git reset --hard [commit]
# 重置当前HEAD为指定commit,但保持暂存区和工作区不变
$ git reset --keep [commit]
# 新建一个commit,用来撤销指定commit
# 后者的所有变化都将被前者抵消,并且应用到当前分支
$ git revert [commit]
# 保存目前的工作目录和暂存区状态,并返回到干净的工作空间
# 将工作区现场(已跟踪文件)储藏起来(stash区,可以看成栈),等以后恢复后继续工作
$ git stash
# 恢复工作现场
$ git stash apply
#删除stash内容
$ git stash drop
# 恢复的同时直接删除stash内容
# stash pop = stash apply + stash drop
$ git stash pop
# 恢复指定的工作现场,当你保存了不只一份工作现场时
git stash apply stash@{0}
-
reset VS checkout:git checkout 和 git reset 都可以使HEAD指向发生改变
命令 |
范例 |
移动(HEAD/branch) |
说明 |
git reset [commit] |
git reset HEAD^ —soft |
是/是 |
完全回退到某提交 |
git reset [file] |
git reset README.md |
否/否 |
恢复暂存区到某提交状态 |
git checkout [commit] |
git checkout master |
是/否 |
移动当前指针HEAD到某提交 |
git checkout [file] |
git checkout — README.md 或 git checkout HEAD — xx.log |
否/否 |
恢复工作目录到某状态 |
其它
# 生成一个可供发布的压缩包
$ git archive
参考