Git操作指南

Git操作指南

git是分布式版本控制系统，想了解更清楚的可以查阅百度百科。在说明操作指南前，我先给大家说明几个专业术词。

<pre>

1. Workspace：工作区
2. Index / Stage：暂存区
3. Repository：仓库区（或本地仓库）
4. Remote：远程仓库
   </pre>

1. 初始化仓库

<pre>
mkdir learngit //创建一个文件夹
cd learngit //切换当前目录
pwd //显示当前目录完整路径
git init //初始化目录，在当前目录新建一个Git代码库
git init [project-name] //新建一个目录，将其初始化为Git代码库
git clone [url] //下载一个项目和它的整个代码历史
ls -ah //显示当前目录所有文件，包括隐藏文件
</pre>

2. 配置

Git的设置文件为.gitconfig，它可以在用户主目录下（全局配置），也可以在项目目录下（项目配置）。 ** 注意-- 代表的是两个-，请勿写错，下文全部如此 **

<pre>
git config --list //显示当前的Git配置
git config -e [--global] //编辑Git配置文件
git config [--global] user.name "[name]" //设置提交代码时的用户信息
git config [--global] user.email "[email address]"
</pre>

3. 增加/删除文件

<pre>
git add [file1] [file2] ... //添加指定文件到暂存区
git add [dir] //添加指定目录到暂存区，包括子目录
git add . //添加当前目录的所有文件到暂存区
git add -p //添加每个变化前，都会要求确认，对于同一个文件的多处变化，可以实现分次提交
git rm [file1] [file2] ... //删除工作区文件，并且将这次删除放入暂存区
git rm --cached [file] //停止追踪指定文件，但该文件会保留在工作区
git mv [file-original] [file-renamed] //改名文件，并且将这个改名放入暂存区
</pre>

4. 代码提交

修改文件内容后git status会提示use "git add" and/or "git commit -a"注意先add后commit，不可以直接commit

<pre>
cd.>readme.txt //创建一个空文件
git add readme.txt //把文件添加到git仓库
git status //查看当前仓库文件改动状态
git diff //是工作区(work dict)和暂存区(stage)的比较
git diff --cached //是暂存区(stage)和分支(master)的比较
git commit -m [message] //提交暂存区到仓库区，加上改动说明
git commit [file1] [file2] ... -m [message] //提交暂存区的指定文件到仓库区
git commit -a //提交工作区自上次commit之后的变化，直接到仓库区
git commit -v //提交时显示所有diff信息
git commit --amend -m [message] //使用一次新的commit，替代上一次提交，如果代码没有任何新变化，则用来改写上一次commit的提交信息
git commit --amend [file1] [file2] ... //重做上一次commit，并包括指定文件的新变化
</pre>

5. 分支

<pre>
git branch //列出所有本地分支
git branch -r //列出所有远程分支
git branch -a //列出所有本地分支和远程分支
git branch [branch-name] //新建一个分支，但依然停留在当前分支
git checkout -b [branch] // 新建一个分支，并切换到该分支
git branch [branch] [commit] // 新建一个分支，指向指定commit
git branch --track [branch] [remote-branch] //新建一个分支，与指定的远程分支建立追踪关系
git checkout [branch-name] //切换到指定分支，同时重置缓存区和工作区，如果工作区有修改没有提交,需要先commit或stash
git checkout -- file命令中的--很重要，没有--，就变成了“切换到另一个分支”的命令
git checkout branch --force //切换branch,同时重置缓存区和工作区
git checkout - //切换到上一个分支
git branch --set-upstream [branch] [remote-branch] //建立追踪关系，在现有分支与指定的远程分支之间
git merge [branch] // 合并指定分支到当前分支
git cherry-pick [commit] //选择一个commit，合并进当前分支
git branch -d [branch-name] //删除分支
git push origin --delete [branch-name] //删除远程分支
git branch -dr [remote/branch] //删除远程分支
</pre>

6. 查看信息

<pre>
git status //显示有变更的文件
git log //显示当前分支的版本历史
git log --stat //显示commit历史，以及每次commit发生变更的文件
git log -S [keyword] // 搜索提交历史，根据关键词
git log [tag] HEAD --pretty=format:%s //显示某个commit之后的所有变动，每个commit占据一行
git log [tag] HEAD --grep feature //显示某个commit之后的所有变动，其"提交说明"必须符合搜索条件
git log --follow [file] //显示某个文件的版本历史，包括文件改名
git whatchanged [file] //显示某个文件的版本历史，包括文件改名
git log -p [file] //显示指定文件相关的每一次diff
git log -5 --pretty --oneline //显示过去5次提交
git shortlog -sn //显示所有提交过的用户，按提交次数排序
git blame [file] //显示指定文件是什么人在什么时间修改过
git diff // 显示暂存区和工作区的差异
git diff --cached [file] //显示暂存区和上一个commit的差异
git diff HEAD //显示工作区与当前分支最新commit之间的差异
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 //显示当前分支的最近几次提交
</pre>

7. 远程同步

<pre>
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 //推送所有分支到远程仓库
</pre>

8. 撤销

<pre>
git checkout [file] //恢复暂存区的指定文件到工作区
git checkout [commit] [file] //恢复某个commit的指定文件到暂存区和工作区
git checkout . //恢复暂存区的所有文件到工作区
git reset [file] //重置暂存区的指定文件，与上一次commit保持一致，但工作区不变
git reset --hard //重置暂存区与工作区，与上一次commit保持一致
git reset [commit] //重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变
git reset --hard [commit] //重置当前分支的HEAD为指定commit，同时重置暂存区和工作区，与指定commit一致
git reset --keep [commit] //重置当前HEAD为指定commit，但保持暂存区和工作区不变
git revert [commit] //新建一个commit，用来撤销指定commit,后者的所有变化都将被前者抵消，并且应用到当前分支
git stash //暂时将未提交的变化移除，稍后再移入
git stash pop
</pre>

9. 解决冲突

多人合作的实际开发中，当我们合并分支或者合并文件，突然产生冲突。解决冲突的方法为：

<pre>

1. 使用任意的文本编辑工具编辑有冲突的文件，去除冲突标记（就是>>>>>>>> ======= <<<<<<这样的东西），并把文本冲突解决掉。
2. 然后使用git add 有冲突的文件，这时文件的冲突标记就变成了修改标记了（在windows下安装TortoiseGit就能看到文件图标的变化了）。
3. 将所有有冲突的文件解决完后，使用git commit -a -m "Xxx"提交就算完成整个合并过程了。
   </pre>

注意，当本地修改文件无法使用git pull拉取远程仓库代码，需要自己手动缓存自己本地的操作。具体操作如下：

<pre>

1. git stash //这样本地的所有修改就都被暂时存储起来 。可以用git stash list可以看到保存的信息：git stash暂存修改 。其中stash@{0}就是刚才保存的标记。
2. git pull //暂存了本地修改之后，就可以pull了。
3. git stash pop stash@{0} //还原暂存的内容，系统提示如下类似的信息：Auto-merging c/environ.c CONFLICT (content): Merge conflict in c/environ.c 意思就是系统自动合并修改的内容，但是其中有冲突，需要解决其中的冲突。
4. 解决文件中冲突的的部分参照前者方法
   </pre>

参考引自阮一峰的常用 Git 命令清单