Git使用教程

1 基本概念

基本概念
我们先来理解下 Git 工作区、暂存区和版本库概念：

• 工作区：就是你在电脑里能看到的目录。
• 暂存区：英文叫 stage 或 index。一般存放在 .git 目录下的 index 文件（.git/index）中，所以我们把暂存区有时也叫作索引（index）。
• 版本库：工作区有一个隐藏目录 .git，这个不算工作区，而是 Git 的版本库。
  下面这个图展示了工作区、版本库中的暂存区和版本库之间的关系：
  
  
  
  
  
  
  

1.1 新建代码库

在当前目录新建一个Git代码库 $ git init
新建一个目录，将其初始化为Git代码库 $ git init [project-name]
下载一个项目和它的整个代码历史 $ git clone [url]

1.2 配置

Git的设置文件为.gitconfig，它可以在用户主目录下（全局配置），也可以在项目目录下（项目配置）。
显示当前的Git配置 $ git config --list
编辑Git配置文件 $ git config -e [–global]
设置提交代码时的用户信息 $ git config [–global] user.name “[name]”
$ git config [–global] user.email “[email address]”

设置用户名：git config --global user.name “name”
设置用户邮箱：git config --global user.email “eamil”

1.3 增加/删除文件

添加指定文件到暂存区 $ 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]

1.4 代码提交

提交暂存区到仓库区 $ 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] …

1.5 分支

列出所有本地分支 $ 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] # 切换到上一个分支 $ git checkout -
建立追踪关系，在现有分支与指定的远程分支之间 $ git branch --set-upstream [branch] [remote-branch]
合并指定分支到当前分支 $ git merge [branch] # 选择一个commit，合并进当前分支 $ git cherry-pick [commit]
删除分支 $ git branch -d [branch-name]
删除远程分支 $ git push origin --delete [branch-name] $ git branch -dr [remote/branch]

1.6 标签

列出所有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]

1.7 查看信息

显示有变更的文件 $ git status
显示当前分支的版本历史 $ 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
显示暂存区和上一个commit的差异 $ git diff --cached [file]
显示工作区与当前分支最新commit之间的差异 $ git diff HEAD
显示两次提交之间的差异 $ 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

从本地master拉取代码更新当前分支：branch 一般为master
$ git rebase [branch]

1.8 远程同步

$ git remote update --更新远程仓储
下载远程仓库的所有变动 $ 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 init
• 将本地内容添加至git本地暂存区中git add .
• 将暂存区添加至本地仓库中git commit -m “first commit”
• 添加远程仓库路径git remote add origin https://github.com/gybguohao/test.git
• 将本地内容push至远程仓库中git push -u origin master

1.9 撤销

恢复暂存区的指定文件到工作区 $ git checkout [file]
恢复某个commit的指定文件到暂存区和工作区 $ git checkout [commit] [file]
恢复暂存区的所有文件到工作区 $ git checkout .
重置暂存区的指定文件，与上一次commit保持一致，但工作区不变 $ git reset [file]
重置暂存区与工作区，与上一次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]
暂时将未提交的变化移除，稍后再移入 $ git stash $ git stash pop

2 Git基本命令汇总

2.1 查看本地文件状态

git status —-查看本地、本地仓库、缓存（stash）的文件修改状态

—红色 代表本地工作空间的文件修改

—蓝色 代表提交到本地仓库中的文件(git add .)

2.2 切换版本/覆盖当前修改文件

git branch - 查看当前版本

git branch -a 查看所有版本

git checkout XXX(版本名) —-切换到远程库中XXX版本

git checkout filepath —覆盖当前修改的文件

git checkout . -覆盖当前所有修改文件

2.3 从远程库获取最新代码

git remote -查看远程库名称

git remote -v

git remote show XXX(远程库名)

git fetch — 从remote端拉取最新代码

git pull XXX(远程库名) XXX(分支名) -把拉取的最新代码跟当前工作空间合并

git rebase —把远程拉回的代码和本地合并

2.4 缓存本地代码

当要切换到其它版本时，想保存在当前版本修改的文件：在切换前做

git stash —-把本地修改过不需要提交的文件放入缓存

git checkout XXX(版本) —切换库版本

切回原来的库，把文件从stash缓存中拿出来

git stash pop — 从缓存中拉出

2.5 提交远程库

git add .

git commit -m ‘’

git remote 查看远程关联名称

git push remote的名称 本地master

2.6 处理冲突

git fetch 拉取最新工程

git pull XXX(远程库名) XXX(分支名) -把拉取的最新代码跟当前工作空间合并

冲突产生后，去工作空间修改后，>>>新代码===老代码<<<,保留最终代码，删除提示符，重新提交。

2.7 把本次提交的内容提交到其他分支（比如发布时bug的修改）

git cherry-pick commitId

2.8 建议执行顺序

git status 查看修改状态

git checkout filename 放弃某文件的修改。

git stash 储存修改

git fetch 拉取最新工程

git rebase 与本地分支合并

git stash pop 弹出储存文件，此时新文件可能会与你的文件产生冲突，解决冲突。

git add filename 添加某个修改文件

git add . 提交所有加点

git reset HEAD filename 回滚指定文件，回滚所有加点："git reset HEAD . "

git commit -m’’

git push 本地remote远程分支名，本地分支名

例我的本地分支为master 远程remote 别名为 origin 则提交为git push origin master

2.9 切换HEAD

git reflog --查看HEAD记录

git reset --hard HEAD^ //切换到之前一个HEAD

git reset --hard fad4462 // 切换到某个已经回退的HEAD

2.10 刪除 local branch

git branch -d <branch_name>

3 Git忽略提交的3种方法及Git忽略规则

在使用Git的过程中，我们喜欢有的文件比如日志，临时文件，编译的中间文件等不要提交到代码仓库，这时就要设置相应的忽略规则，来忽略这些文件的提交。

Git 忽略文件提交的方法
有三种方法可以实现忽略Git中不想提交的文件。

3.1 在Git项目中定义 .gitignore 文件

这种方式通过在项目的某个文件夹下定义 .gitignore 文件，在该文件中定义相应的忽略规则，来管理当前文件夹下的文件的Git提交行为。

.gitignore 文件是可以提交到公有仓库中，这就为该项目下的所有开发者都共享一套定义好的忽略规则。

在 .gitingore 文件中，遵循相应的语法，在每一行指定一个忽略规则。如：

*.log
*.temp
/vendor2\

3.2 在Git项目的设置中指定排除文件

这种方式只是临时指定该项目的行为，需要编辑当前项目下的 .git/info/exclude 文件，然后将需要忽略提交的文件写入其中。

需要注意的是，这种方式指定的忽略文件的根目录是项目根目录。

3.3 定义Git全局的 .gitignore 文件

除了可以在项目中定义 .gitignore 文件外，还可以设置全局的 git .gitignore 文件来管理所有Git项目的行为。这种方式在不同的项目开发者之间是不共享的，是属于项目之上Git应用级别的行为。

这种方式也需要创建相应的 .gitignore 文件，可以放在任意位置。然后在使用以下命令配置Git：
git config --global core.excludesfile ~/.gitignore
Git忽略规则

Git忽略规则优先级
在 .gitingore 文件中，每一行指定一个忽略规则，Git 检查忽略规则的时候有多个来源，它的优先级如下（由高到低）：

从命令行中读取可用的忽略规则
当前目录定义的规则
父级目录定义的规则，依次递推
$GIT_DIR/info/exclude 文件中定义的规则
core.excludesfile中定义的全局规则
Git 忽略规则匹配语法
.gitignore文件中的忽略规则

在 .gitignore 文件中，每一行的忽略规则的语法如下：

空格不匹配任意文件，可作为分隔符，可用反斜杠转义

开头的文件标识注释，可以使用反斜杠进行转义

! 开头的模式标识否定，该文件将会再次被包含，如果排除了该文件的父级目录，则使用 ! 也不会再次被包含。可以使用反斜杠进行转义
/ 结束的模式只匹配文件夹以及在该文件夹路径下的内容，但是不匹配该文件
/ 开始的模式匹配项目跟目录
如果一个模式不包含斜杠，则它匹配相对于当前 .gitignore 文件路径的内容，如果该模式不在 .gitignore 文件中，则相对于项目根目录
** 匹配多级目录，可在开始，中间，结束
? 通用匹配单个字符
[] 通用匹配单个字符列表
常用匹配示例：
bin/: 忽略当前路径下的bin文件夹，该文件夹下的所有内容都会被忽略，不忽略 bin 文件
/bin: 忽略根目录下的bin文件
/.c: 忽略 cat.c，不忽略 build/cat.c
debug/.obj: 忽略 debug/io.obj，不忽略 debug/common/io.obj 和 tools/debug/io.obj
/foo: 忽略/foo, a/foo, a/b/foo等
a//b: 忽略a/b, a/x/b, a/x/y/b等
!/bin/run.sh: 不忽略 bin 目录下的 run.sh 文件
*.log: 忽略所有 .log 文件
config.php: 忽略当前路径的 config.php 文件
.gitignore规则不生效
.gitignore只能忽略那些原来没有被track的文件，如果某些文件已经被纳入了版本管理中，则修改.gitignore是无效的。

解决方法就是先把本地缓存删除（改变成未track状态），然后再提交:

git rm -r --cached .
git add .
git commit -m 'update .gitignore'