Git 手册
参考资料：一个小时学会Git
1、Git配置 - git config
语法: git config [<options>]
文件位置
--global #use global config file 使用全局配置文件 当前用户级
--system #use system config file 使用系统配置文件 系统级
--local #use repository config file 使用存储库配置文件 项目级
-f, --file <file> #use given config file 使用给定的配置文件
--blob <blob-id> #read config from given blob object 从给定的对象中读取配置
动作
--get #get value: name [value-regex] 获得值：[值]名[正则表达式]
--get-all #get all values: key [value-regex] 获得所有值：[值]名[正则表达式]
--get-regexp #get values for regexp: name-regex [value-regex] 得到的值根据正则
--get-urlmatch #get value specific for the URL: section[.var] URL 为URL获取特定的值
--replace-all #replace all matching variables: name value [value_regex] 替换所有匹配的变量：名称值[ value_regex ]
--add #add a new variable: name value 添加一个新变量：name值
--unset #remove a variable: name [value-regex] 删除一个变量名[值]：正则表达式
--unset-all #remove all matches: name [value-regex] 删除所有匹配的正则表达式：名称[值]
--rename-section #rename section: old-name new-name 重命名部分：旧名称 新名称
--remove-section #remove a section: name 删除部分：名称
-l, --list #list all 列出所有
-e, --edit #open an editor 打开一个编辑器
--get-color #find the color configured: slot [default] 找到配置的颜色：插槽[默认]
--get-colorbool #find the color setting: slot [stdout-is-tty] 发现颜色设置：槽[ stdout是TTY ]
类型
--bool #value is "true" or "false" 值是“真”或“假”。
--int #value is decimal number 值是十进制数。
--bool-or-int #value is --bool or --int 值--布尔或int
--path #value is a path (file or directory name) 值是路径（文件或目录名）
其它
-z, --null #terminate values with NUL byte 终止值与null字节
--name-only #show variable names only 只显示变量名
--includes #respect include directives on lookup 尊重包括查找指令
--show-origin #show origin of config (file, standard input, blob, command line) 显示配置（文件、标准输入、数据块、命令行）的来源
2、工作区域
Git本地有三个工作区域：工作目录（Working Directory）、暂存区(Stage/Index)、资源库(Repository或Git Directory)。如果在加上远程的git仓库(Remote Directory)就可以分为四个工作区域。文件在这四个区域之间的转换关系如下：
Workspace：工作区，就是你平时存放项目代码的地方
Index / Stage：暂存区，用于临时存放你的改动，事实上它只是一个文件，保存即将提交到文件列表信息
Repository：仓库区（或本地仓库），就是安全存放数据的位置，这里面有你提交到所有版本的数据。其中HEAD指向最新放入仓库的版本
Remote：远程仓库，托管代码的服务器，可以简单的认为是你项目组中的一台电脑用于远程数据交换
Directory：使用Git管理的一个目录，也就是一个仓库，包含我们的工作空间和Git的管理空间。
WorkSpace：需要通过Git进行版本控制的目录和文件，这些目录和文件组成了工作空间。
.git：存放Git管理信息的目录，初始化仓库的时候自动创建。
Index/Stage：暂存区，或者叫待提交更新区，在提交进入repo之前，我们可以把所有的更新放在暂存区。
Local Repo：本地仓库，一个存放在本地的版本库；HEAD会只是当前的开发分支（branch）。
Stash：隐藏，是一个工作状态保存栈，用于保存/恢复WorkSpace中的临时状态。
3、Git操作
3.1、创建工作目录与常用指令
工作目录（WorkSpace)一般就是你希望Git帮助你管理的文件夹，可以是你项目的目录，也可以是一个空目录，建议不要有中文。
# 在当前目录新建一个Git代码库
$ git init
# 新建一个目录，将其初始化为Git代码库
$ git init [project-name]
# 克隆一个项目和它的整个代码历史(版本信息)
$ git clone [url]
3.2、GIT文件操作
版本控制就是对文件的版本控制，要对文件进行修改、提交等操作，首先要知道文件当前在什么状态，不然可能会提交了现在还不想提交的文件，或者要提交的文件没提交上。GIT不关心文件两个版本之间的具体差别，而是关心文件的整体是否有改变，若文件被改变，在添加提交时就生成文件新版本的快照，而判断文件整体是否改变的方法就是用SHA-1算法计算文件的校验和。
3.2.1、文件4种状态
Untracked: 未跟踪, 此文件在文件夹中, 但并没有加入到git库, 不参与版本控制. 通过git add 状态变为Staged.
Unmodify: 文件已经入库, 未修改, 即版本库中的文件快照内容与文件夹中完全一致. 这种类型的文件有两种去处, 如果它被修改, 而变为Modified. 如果使用git rm移出版本库, 则成为Untracked文件
Modified: 文件已修改, 仅仅是修改, 并没有进行其他的操作. 这个文件也有两个去处, 通过git add可进入暂存staged状态, 使用git checkout 则丢弃修改过, 返回到unmodify状态, 这个git checkout即从库中取出文件, 覆盖当前修改
Staged: 暂存状态. 执行git commit则将修改同步到库中, 这时库中的文件和本地文件又变为一致, 文件为Unmodify状态. 执行git reset HEAD filename取消暂存, 文件状态为Modified
3.2.2、添加文件与目录
将untracked状态的文件添加到暂存区，语法格式如下：
# 添加指定文件到暂存区
$ git add [file1] [file2] ...
# 添加指定目录到暂存区，包括子目录
$ git add [dir]
# 添加当前目录的所有文件到暂存区
$ git add .
执行：
echo "hello foo" > foo.htm # 创建foo.htm 并写入内容
echo "hello bar" > bar.htm # 创建bar.htm 并写入内容
echo "hello qux" > qux.htm # 创建qux.htm 并写入内容
git add foo.htm // 添加文件至暂存区
git status foo.htm // 查看文件状态
3.2.3、移除文件与目录（撤销add）
当执行如下命令时，会直接从暂存区删除文件，工作区则不做出改变
#直接从暂存区删除文件，工作区则不做出改变
git rm --cached <file>
执行命令
git rm --cached foo.htm
git status foo.htm
通过重写目录树移除add文件
#如果已经用add 命令把文件加入stage了，就先需要从stage中撤销
git reset HEAD <file>...
当执行 “git reset HEAD” 命令时，暂存区的目录树会被重写，被 master 分支指向的目录树所替换，但是工作区不受影响。
# 准备
echo "f1.txt" > f1.txt
echo "f2.txt" > f2.txt
echo "f1.log" > f1.log
echo "f2.log" > f2.log
git add f1.txt
git add f2.txt
# 执行
git reset HEAD f1.txt
移除所有未跟踪文件
语法：
#移除所有未跟踪文件
#一般会加上参数-df，-d表示包含目录，-f表示强制清除。
git clean [options]
示例
// 准备：
echo "temp1" > temp1.txt
git status temp1
// 移除前
dir
//执行移除
git clean =df
// 移除
dir
注意：
#只从stage中删除，保留物理文件
git rm --cached readme.txt
#不但从stage中删除，同时删除物理文件
git rm readme.txt
#把a.txt改名为b.txt
git mv a.txt b.txt
3.2.4、查看文件修改后的差异
git diff用于显示WorkSpace中的文件和暂存区文件的差异
用"git status"只能查看对哪些文件做了改动，如果要看改动了什么，可以用：
#查看文件修改后的差异
git diff [files]
示例：
# 准备
echo "hello world" > hello.txt #创建hello.txt
git add hello.txt
echo "hello git" > hello.txt #修改hello.txt的内容
git diff #查看文件修改后的差异
echo "hello2 world" > hello2.txt #创建hello.txt
git add hello2.txt
echo "hello2 git" > hello2.txt #修改hello.txt的内容
git diff hello2.txt #查看指定文件修改后的差异
3.2.5、签出
如果仓库中已经存在文件f4.txt，在工作区中对f4修改了，如果想撤销可以使用checkout，签出覆盖
检出命令git checkout是git最常用的命令之一，同时也是一个很危险的命令，因为这条命令会重写工作区
语法：
#用法一
git checkout [-q] [<commit>] [--] <paths>...
#用法二
git checkout [<branch>]
#用法三
git checkout [-m] [[-b]--orphan] <new_branch>] [<start_point>]
<commit>是可选项，如果省略则相当于从暂存区（index）进行检出
$ git checkout branch
#检出branch分支。要完成图中的三个步骤，更新HEAD以指向branch分支，以及用branch 指向的树更新暂存区和工作区。
$ git checkout
#汇总显示工作区、暂存区与HEAD的差异。
$ git checkout HEAD
#同上
$ git checkout -- filename
#用暂存区中filename文件来覆盖工作区中的filename文件。相当于取消自上次执行git add filename以来（如果执行过）的本地修改。
$ git checkout branch -- filename
#维持HEAD的指向不变。用branch所指向的提交中filename替换暂存区和工作区中相 应的文件。注意会将暂存区和工作区中的filename文件直接覆盖。
$ git checkout -- . 或写作 git checkout .
#注意git checkout 命令后的参数为一个点（“.”）。这条命令最危险！会取消所有本地的 #修改（相对于暂存区）。相当于用暂存区的所有文件直接覆盖本地文件，不给用户任何确认的机会！
$ git checkout commit_id -- file_name
#如果不加commit_id，那么git checkout -- file_name 表示恢复文件到本地版本库中最新的状态。
示例：
＃ 准备：
echo "f4">f4.txt
git add f4.txt
git commit -m "f4提交"
git status f4.txt
# 示例
echo "flower four ">f4.txt
git diff f4.txt
git checkout f4.txt
more f4.txt
3.2.6、忽略文件
有些时候我们不想把某些文件纳入版本控制中，比如数据库文件，临时文件，设计文件等
在主目录下建立".gitignore"文件，此文件有如下规则：
忽略文件中的空行或以井号（#）开始的行将会被忽略。
可以使用Linux通配符。例如：星号（*）代表任意多个字符，问号（？）代表一个字符，方括号（[abc]）代表可选字符范围，大括号（{string1,string2,...}）代表可选的字符串等。
如果名称的最前面有一个感叹号（!），表示例外规则，将不被忽略。
如果名称的最前面是一个路径分隔符（/），表示要忽略的文件在此目录下，而子目录中的文件不忽略。
如果名称的最后面是一个路径分隔符（/），表示要忽略的是此目录下该名称的子目录，而非文件（默认文件或目录都忽略）。
示例：
#为注释
*.txt #忽略所有 .txt结尾的文件
!lib.txt #但lib.txt除外
/temp #仅忽略项目根目录下的TODO文件,不包括其它目录temp
build/ #忽略build/目录下的所有文件
doc/*.txt #会忽略 doc/notes.txt 但不包括 doc/server/arch.txt
3.2.7、提交
通过add只是将文件或目录添加到了index暂存区，使用commit可以实现将暂存区的文件提交到本地仓库。
# 提交暂存区到仓库区
$ git commit -m [message]
# 提交暂存区的指定文件到仓库区
$ git commit [file1] [file2] ... -m [message]
# 提交工作区自上次commit之后的变化，直接到仓库区，跳过了add,对新文件无效
$ git commit -a
# 提交时显示所有diff信息
$ git commit -v
# 使用一次新的commit，替代上一次提交
# 如果代码没有任何新变化，则用来改写上一次commit的提交信息
$ git commit --amend -m [message]
# 重做上一次commit，并包括指定文件的新变化
$ git commit --amend [file1] [file2] ...
3.3、GIT分支
git分支中常用指令：
# 列出所有本地分支
$ 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）、新建一个分支，但依然停留在当前分支，使用：$ git branch [branch-name]
git branch dev1
git branch 查看所有分支
# 2）、切换分支，git checkout <name>，如果name为-则为上一个分支
git checkout dev1
git checkout -
3）、新建一个分支，并切换到该分支，$ git checkout -b [branch]
git checkout -b dev2
4) 、新建一个分支，指向指定commit使用命令：$ git branch [branch] [commit]
3.4、分支合并
合并指定分支到当前分支使用指令$ git merge [branch]
这里的合并分支就是对分支的指针操作，我们先创建一个分支再合并到主分支：
#准备
echo "file1 context" > file1.txt //添加 file1.txt
git add .
git commit -m "提交file1.txt"
git checkout -b dev6
echo "modified " >> file1.txt //修改 file1.txt
git add .
git commit -m "修改file1.txt"
more file1.txt
3.5、解决冲突
分支策略
master主分支应该非常稳定，用来发布新版本，一般情况下不允许在上面工作，工作一般情况下在新建的dev分支上工作，工作完后，比如上要发布，或者说dev分支代码稳定后可以合并到主分支master上来。
删除远程分支可以使用如下指令：
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]
4、Git 标签
如果你达到一个重要的阶段，并希望永远记住那个特别的提交快照，你可以使用 git tag 给它打上标签。
比如说，我们想为我们的 runoob 项目发布一个"1.0"版本。 我们可以用 git tag -a v1.0 命令给最新一次提交打上（HEAD）"v1.0"的标签。
-a 选项意为"创建一个带注解的标签"。 不用 -a 选项也可以执行的，但它不会记录这标签是啥时候打的，谁打的，也不会让你添加个标签的注解。 我推荐一直创建带注解的标签
$ git tag -a v1.0
git checkout -b [分支名] [标签名]在特定地标签上创建一个新分支
$ git checkout -b version1 v1.0.0
Switched to a new branch 'version1
5、git 帮助
usage: git [--version] [--help] [-C
[--exec-path[=
[-p | --paginate | --no-pager] [--no-replace-objects] [--bare]
[--git-dir=
These are common Git commands used in various situations:
start a working area (see also: git help tutorial)
clone Clone a repository into a new directory
init Create an empty Git repository or reinitialize an existing one
work on the current change (see also: git help everyday)
add Add file contents to the index
mv Move or rename a file, a directory, or a symlink
reset Reset current HEAD to the specified state
rm Remove files from the working tree and from the index
examine the history and state (see also: git help revisions)
bisect Use binary search to find the commit that introduced a bug
grep Print lines matching a pattern
log Show commit logs
show Show various types of objects
status Show the working tree status
grow, mark and tweak your common history
branch List, create, or delete branches
checkout Switch branches or restore working tree files
commit Record changes to the repository
diff Show changes between commits, commit and working tree, etc
merge Join two or more development histories together
rebase Reapply commits on top of another base tip
tag Create, list, delete or verify a tag object signed with GPG
collaborate (see also: git help workflows)
fetch Download objects and refs from another repository
pull Fetch from and integrate with another repository or a local branch
push Update remote refs along with associated objects
'git help -a' and 'git help -g' list available subcommands and some
concept guides. See 'git help
to read about a specific subcommand or concept.
6、最佳实践
6.1 创建 Github 仓库
6.2 git clone
克隆到本地：
$ cd /d/python-code/
$ git clone git@github.com:wangy8961/flask-vuejs-madblog.git
6.3 init commit
添加 MIT License，然后第一次提交：
$ cd flask-vuejs-madblog/
$ git status
$ git add .
$ git commit -m "init"
$ git push
6.4 先init 后推送
git init
git add .
git commit -am 'init'
git remote add origin https://github.com/xxx/xxx.git
git pull origin master --allow-unrelated-histories ### 方法解决因为两个仓库有不同的开始点
异常解决：git push error: failed to push some refs to
使用如下命令：git pull --rebase origin master
然后再进行上传: git push -u origin master
6.5 分支管理
创建 dev 开发分支：
$ git checkout -b dev
$ git branch
* dev
master
6.6. 提交代码
$ git add .
$ git commit -m "1. 后端Flask RESTful API提供测试接口 Ping-Pong!"
$ git checkout master
$ git merge dev
$ git branch -d dev
$ git branch
将本地 master 分支代码上传到 Github 代码仓库中的 master 分支：
$ git push
或者：
$ git push -u origin master
6.7. 打上标签 tag并上传
打上标签 tag并上传：
$ git tag v0.1
$ git tag
v0.1
$ git show v0.1
git push origin v0.1
6.8、 Start development from a known tag
$ git clone git://git.kernel.org/pub/scm/.../linux-2.6 my2.6
$ cd my2.6
$ git branch my2.6.14 v2.6.14 (1)
$ git checkout my2.6.14
