git 基础操作

git：实际上就是一个单向有环图

- commit、index 与 work 之间的关系
- commit 与 branch、HEAD 指针之间的关系
branch 代表了 commit 树的叶子节点
- commit 与 tag 之间的关系

git使用命令
Commit message 和 Change log 编写指南
Git 工作流程
常用 Git 命令清单
http://wsgzao.github.io/post/git/

https://git-scm.com/book/zh/v2


- 未追踪
- 不想每次使用git status命令时让它们显示出来
$ git clean -f -n # 1
$ git clean -f # 2
$ git clean -fd # 3
$ git clean -fX # 4
$ git clean -fx # 5
(1): 选项-n将显示执行（2）时将会移除哪些文件。
(2): 该命令会移除所有命令（1）中显示的文件。
(3): 如果你还想移除文件件，请使用选项-d。
(4): 如果你只想移除已被忽略的文件，请使用选项-X。
(5): 如果你想移除已被忽略和未被忽略的文件，请使用选项-x。

- 暂存区
- 移除暂存区的文件
git reset <文件名>

- 从暂存区移除所有没有提交的修改
git reset

- commit

- 编辑最近一次的提交信息，但是你必须确保没有对当前的代码库做修改，否则这些修改也会随之一起提交
>> git commit --amend -m ”YOUR-NEW-COMMIT-MESSAGE”
- 假如你已经将代码提交（git commit）推送（git push）到了远程分支，那么你需要通过下面的命令强制推送这次的代码提交
>> $ git push <remote> <branch> --force

- 提交了错误的文件或一开始就遗漏了某些东西
$ git reset --soft HEAD~1 # 恢复到执行 commit 之前，提交暂存区之后的时间点
# 对工作文件进行必要的更改，注意暂存区
$ git add -A .
$ git commit -c ORIG_HEAD

- 指针

- 指针脱离，并从某一个 commit 中开启新的分支
$ git checkout <SHA>
$ git checkout -b <SHA>


1.git文件变化流

┌─────────────┐ checkout < checkout <file> ┌───────────────┐
│ │ ───────────────────┬────────────────────────────▶ │ WorkSpace │
│ │ │ │ │
│ Reposiroty │ │ │ │
│ │ │ │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ ┌─┴─────────────┐ │ │
│ │ reset HEAD │ Index/Stage │ checkout │ │
│ │ ───────────────▶ │ │ ─────────────▶ │ │
│ │ │ │ │ │
│ │ │ │ │ │
│ │ │ │ │ │
│ │ ◀─────────────── │ │ ◀───────────── │ │
│ │ commit │del:rm --cached│ add <file> │ │
└──┬────────┬─┘ └───────────────┘ └─────────────┬─┘
│ ▲ ▲
push│ │ clone │ pull
▼ │ │
┌──┴────────┴───────────────────────────────────────────────────────────────────┴──┐
│ Remote │
│ │
│ │
│ │
│ │
└──────────────────────────────────────────────────────────────────────────────────┘

2.常用

git clone <git_repo> <dir_name>
# 自动将远端主机命名为 origin
git clone -o <remote_name> <git_repo> <dir_name>
# 将远端主机命名为 <remote_name>，而不是默认的 origin

git remote add <主机名> <网址>
git remote rm <主机名>
git remote rename <原主机名> <新主机名>
git remote show <主机名>
git remote [-v]
# 远端主机的增删改查


3.增删改查
1).当前时间点

- 增加

# work → index
git add a.txt

# index → repo
git commit -m "add file: a.txt"

- 查看

git status
git diff

- 删除

# 从 index 中删除，并会在下一次 commit 时提交给 repo；
# 此时 work 中也会删除；
git rm a.txt

# 从 index 中删除，并会在下一次 commit 时提交给 repo；
# 但 work 中不会删除，此时 a.txt 就成了一个 Untracked 文件了；
git rm --cached a.txt

- 撤销修改

# index → work
git checkout -- c.txt

# repo → index
git reset HEAD c.txt

# repo → index && repo → work
git checkout HEAD -- c.txt

- 修改 commit

# 提交后发现忘记了暂存某些需要的修改，可以像下面这样操作
$ git commit -m 'initial commit'
$ git add forgotten_file
$ git commit --amend

# 重命名
git mv a.txt b.txt

2).操作时间点/时间线

在Git中，用HEAD表示当前版本，也就是最新的提交3628164...882e1e0（注意我的提交ID和你的肯定不一样），上一个版本就是HEAD^，上上一个版本就是HEAD^^，当然往上100个版本写100个^比较容易数不过来，所以写成HEAD~100。

git reset --hard HEAD^
# 回退到最近提交 commit 的快照；

git reset --hard 3628164
# 回退到指定的 commit 时间；
# 可以使用 git reflog 来查看你曾经跳跃过的时间点；
# 版本号没必要写全，前几位就可以了，Git会自动去找

- log

# 查看 repo 与 work 有哪些改动(新文件，文件改动)；查看 repo 和 index 之间的不同(index中是否有文件还未提交到 repo)

# 查看详细 repo 和 work 之间的的改动内容

git log --pretty=oneline
# 查看 repo 中的 commit 历史归档；
# 参数 --pretty=oneline 表示以简洁的方式来显示；

git 的 repo 会记录每一次commit的时间线，你可以使用 git reset 来跳到某一个时间点(commit)上来新开一条线；
或者你现在在一条线上，那么你可以跳到另外一条线上；
注意每一次的时间点跳跃都会直接将该时间点的现场还原到 work中，所以如果你想在跳之后还保存着跳之前的work现场，那么需要在跳之前就 commit 到 repo 才行；

如何查看你曾经跳跃过的时间点：
git reflog

- 查看时间点
git show b10cc123
git diff 09bd8cc ba25c0ff

3).修改时间点/时间线

- 回滚某个文件到之前的版本
git checkout 09bd8cc1 hello.txt

- 修改上一次时间点
会把最新的提交打回暂存区，并尝试重新提交
git commit --amend



4.远程仓库

- 添加远程库

git remote add origin [email protected]:michaelliao/learngit.git
# 添加后，远程库的名字就是origin，这是Git默认的叫法，也可以改成别的，但是origin这个名字一看就知道是远程库。

- 查看远程库

git remote

git remote -v
# -v 表示显示更详细的信息

- 推送到远程库

$ git push origin master
$ git push origin dev

推送分支，就是把该分支上的所有本地提交推送到远程库。
推送时，要指定本地分支，这样，Git就会把该分支推送到远程库对应的远程分支上：

但是，并不是一定要把本地分支往远程推送，那么，哪些分支需要推送，哪些不需要呢？
master分支是主分支，因此要时刻与远程同步；
dev分支是开发分支，团队所有成员都需要在上面工作，所以也需要与远程同步；
bug分支只用于在本地修复bug，就没必要推到远程了，除非老板要看看你每周到底修复了几个bug；
feature分支是否推到远程，取决于你是否和你的小伙伴合作在上面开发。
总之，就是在Git中，分支完全可以在本地自己藏着玩，是否推送，视你的心情而定！

git push -u origin master

由于远程库是空的，我们第一次推送master分支时，加上了-u参数，Git不但会把本地的master分支内容推送的远程新的master分支，还会把本地的master分支和远程的master分支关联起来，在以后的推送或者拉取时就可以简化命令。

- 从远程库拉取

git clone [email protected]:michaelliao/gitskills.git

当你从远程仓库克隆时，实际上Git自动把本地的master分支和远程的master分支对应起来了，并且，远程仓库的默认名称是origin。

- 推送冲突

多人协作时，大家都会往master和dev分支上推送各自的修改。

现在，模拟一个你的小伙伴，可以在另一台电脑（注意要把SSH Key添加到GitHub）或者同一台电脑的另一个目录下克隆：

$ git clone [email protected]:michaelliao/learngit.git
Cloning into 'learngit'...
remote: Counting objects: 46, done.
remote: Compressing objects: 100% (26/26), done.
remote: Total 46 (delta 16), reused 45 (delta 15)
Receiving objects: 100% (46/46), 15.69 KiB | 6 KiB/s, done.
Resolving deltas: 100% (16/16), done.
当你的小伙伴从远程库clone时，默认情况下，你的小伙伴只能看到本地的master分支。不信可以用git branch命令看看：

$ git branch
* master
现在，你的小伙伴要在dev分支上开发，就必须创建远程origin的dev分支到本地，于是他用这个命令创建本地dev分支：

$ git checkout -b dev origin/dev
现在，他就可以在dev上继续修改，然后，时不时地把dev分支push到远程：

$ git commit -m "add /usr/bin/env"
[dev 291bea8] add /usr/bin/env
1 file changed, 1 insertion(+)
$ git push origin dev
Counting objects: 5, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 349 bytes, done.
Total 3 (delta 0), reused 0 (delta 0)
To [email protected]:michaelliao/learngit.git
fc38031..291bea8 dev -> dev

你的小伙伴已经向origin/dev分支推送了他的提交，而碰巧你也对同样的文件作了修改，并试图推送：

$ git add hello.py
$ git commit -m "add coding: utf-8"
[dev bd6ae48] add coding: utf-8
1 file changed, 1 insertion(+)
$ git push origin dev
To [email protected]:michaelliao/learngit.git
! [rejected] dev -> dev (non-fast-forward)
error: failed to push some refs to '[email protected]:michaelliao/learngit.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Merge the remote changes (e.g. 'git pull')
hint: before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
推送失败，因为你的小伙伴的最新提交和你试图推送的提交有冲突，解决办法也很简单，Git已经提示我们，先用git pull把最新的提交从origin/dev抓下来，然后，在本地合并，解决冲突，再推送：

$ git pull
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3 (delta 0), reused 3 (delta 0)
Unpacking objects: 100% (3/3), done.
From github.com:michaelliao/learngit
fc38031..291bea8 dev -> origin/dev
There is no tracking information for the current branch.
Please specify which branch you want to merge with.
See git-pull(1) for details

git pull <remote> <branch>

If you wish to set tracking information for this branch you can do so with:

git branch --set-upstream dev origin/<branch>
git pull也失败了，原因是没有指定本地dev分支与远程origin/dev分支的链接，根据提示，设置dev和origin/dev的链接：

$ git branch --set-upstream dev origin/dev
Branch dev set up to track remote branch dev from origin.
再pull：

$ git pull
Auto-merging hello.py
CONFLICT (content): Merge conflict in hello.py
Automatic merge failed; fix conflicts and then commit the result.
这回git pull成功，但是合并有冲突，需要手动解决，解决的方法和分支管理中的解决冲突完全一样。解决后，提交，再push：

$ git commit -m "merge & fix hello.py"
[dev adca45d] merge & fix hello.py
$ git push origin dev
Counting objects: 10, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (5/5), done.
Writing objects: 100% (6/6), 747 bytes, done.
Total 6 (delta 0), reused 0 (delta 0)
To [email protected]:michaelliao/learngit.git
291bea8..adca45d dev -> dev

因此，多人协作的工作模式通常是这样：
• 首先，可以试图用git push origin branch-name推送自己的修改；
• 如果推送失败，则因为远程分支比你的本地更新，需要先用git pull试图合并；
• 如果合并有冲突，则解决冲突，并在本地提交；
• 没有冲突或者解决掉冲突后，再用git push origin branch-name推送就能成功！
• 如果git pull提示“no tracking information”，则说明本地分支和远程分支的链接关系没有创建，用命令git branch --set-upstream branch-name origin/branch-name。
这就是多人协作的工作模式，一旦熟悉了，就非常简单。


5.分支管理

Git 分支管理详解


- 分支可视化

除了 gitg, 其他常见的Linux上的git UI程序还有 gitk 以及 qgit.

- 概念

截止到目前，只有一条时间线，在Git里，这个分支叫主分支，即master分支；
HEAD严格来说不是指向提交，而是指向master，master才是指向提交的，所以，HEAD指向的就是当前分支。
一开始的时候，master分支是一条线，Git用master指向最新的提交，再用HEAD指向master，就能确定当前分支，以及当前分支的提交点；
每次提交，master分支都会向前移动一步，这样，随着你不断提交，master分支的线也越来越长：

当我们创建新的分支，例如dev时，Git新建了一个指针叫dev，指向master相同的提交，再把HEAD指向dev，就表示当前分支在dev上：

Git创建一个分支很快，因为除了增加一个dev指针，改改HEAD的指向，工作区的文件都没有任何变化！

不过，从现在开始，对工作区的修改和提交就是针对dev分支了，比如新提交一次后，dev指针往前移动一步，而master指针不变：

假如我们在dev上的工作完成了，就可以把dev合并到master上。Git怎么合并呢？最简单的方法，就是直接把master指向dev的当前提交，就完成了合并：

所以Git合并分支也很快！就改改指针，工作区内容也不变！
合并完分支后，甚至可以删除dev分支。删除dev分支就是把dev指针给删掉，删掉后，我们就剩下了一条master分支：

- 创建

git checkout -b dev
# git checkout命令加上-b参数表示创建并切换，相当于以下两条命令：
# $ git branch dev
# $ git checkout dev
# Switched to branch 'dev'

此时 dev 和 master 都执行同一个时间点，但你的 HEAD 指针却发生了变化，从指向 master 变成了指向 dev 了；

- 查看

git branch
# 会列出所有分支，当前分支前面会标一个*号。

git log --graph --pretty=oneline --abbrev-commit
# ascii 码时间线

- 切换分支

git checkout master
# 从当前分支切换到 master 分支；

- 合并分支

git merge dev
# 将 dev 中所做的所有操作，合并到 master 分支中，此时相当于对 master 分支做了一个 commit；

合并模式分两种：--no-ff 与 --ff
--ff：快速合并模式，此时会将合并分支里面的所有变化应用到 master 当前时间点中，删除被合并分支后，该分支的信息将永不存在；
--no-ff：非快速合并，此时master 会再创建一个时间点，在这个时间点来合并分支，这样我们在撤销合并的时候，可以快速回退到 master 合并前的状态；

默认使用 --ff 合并，但不是每次合并都能够快速合并的；



- 撤销合并

回到 master 合并提交新分支之前的那个分支即可；


即回到"add file: e.txt"时间点上即可；

- 删除分支

删除已经被合并的分支：
git branch -d dev
# Deleted branch dev (was 4291bce).
git branch
# * master

删除还未被合并的分支：
git branch -D feature-vulcan

- 分支管理

首先，master分支应该是非常稳定的，也就是仅用来发布新版本，平时不能在上面干活；
那在哪干活呢？干活都在dev分支上，也就是说，dev分支是不稳定的，到某个时候，比如1.0版本发布时，再把dev分支合并到master上，在master分支发布1.0版本；
你和你的小伙伴们每个人都在dev分支上干活，每个人都有自己的分支，时不时地往dev分支上合并就可以了。
所以，团队合作的分支看起来就像这样：



- 现场保存

Git还提供了一个stash功能，可以把当前工作现场“储藏”起来，等以后恢复现场后继续工作
此处的现场值只当前工作的分支内的 index 和 work 保存起来；
保存之后，会直接 git reset --head HEAD 的，此时工作区和 index 就十分干净；

git stash
# 保存现场，并 reset 到当前分支的 HEAD 时间点上；
git stash list
# 现场保存列表；

恢复现场有两种方式：
1.git stash apply 恢复现场，git stash drop 删除现场列表；
2.git stash pop 恢复的同时把stash内容也删了

注意，现场保存只应用于被追踪的文件，未被追踪的文件在整个过程中不会有任何影响；

你可以多次stash，恢复的时候，先用git stash list查看，然后恢复指定的stash，用命令：
$ git stash apply stash@{0}


6，标签管理

发布一个版本时，我们通常先在版本库中打一个标签，这样，就唯一确定了打标签时刻的版本。将来无论什么时候，取某个标签的版本，就是把那个打标签的时刻的历史版本取出来。所以，标签也是版本库的一个快照。

Git的标签虽然是版本库的快照，但其实它就是指向某个commit的指针（跟分支很像对不对？但是分支可以移动，标签不能移动），所以，创建和删除标签都是瞬间完成的。

- 打标签

在Git中打标签非常简单，首先，切换到需要打标签的分支上：
然后，敲命令git tag <name>就可以打一个新标签：

默认标签是打在最新提交的commit上的。有时候，如果忘了打标签，比如，现在已经是周五了，但应该在周一打的标签没有打，怎么办？
方法是找到历史提交的commit id，然后打上就可以了：
$ git tag v0.9 6224937

还可以创建带有说明的标签，用-a指定标签名，-m指定说明文字：
$ git tag -a v0.1 -m "version 0.1 released" 3628164

- 查看标签

$ git tag
# v1.0

注意，标签不是按时间顺序列出，而是按字母排序的。
可以用git show <tagname>查看标签信息：

- 签名标签

以通过-s用私钥签名一个标签：
$ git tag -s v0.2 -m "signed version 0.2 released" fec145a

签名采用PGP签名，因此，必须首先安装gpg（GnuPG），如果没有找到gpg，或者没有gpg密钥对，就会报错：
如果报错，请参考GnuPG帮助文档配置Key。

用命令git show <tagname>可以看到PGP签名信息：

- 删除标签

如果标签打错了，也可以删除：
$ git tag -d v0.1
# Deleted tag 'v0.1' (was e078af9)


如果标签已经推送到远程，要删除远程标签就麻烦一点，先从本地删除：
$ git tag -d v0.9
Deleted tag 'v0.9' (was 6224937)

然后，从远程删除。删除命令也是push，但是格式如下：
$ git push origin :refs/tags/v0.9
To [email protected]:michaelliao/learngit.git
- [deleted] v0.9

- 推送标签

因为创建的标签都只存储在本地，不会自动推送到远程。所以，打错的标签可以在本地安全删除。

如果要推送某个标签到远程，使用命令git push origin <tagname>：
$ git push origin v1.0
Total 0 (delta 0), reused 0 (delta 0)
To [email protected]:michaelliao/learngit.git
* [new tag] v1.0 -> v1.0

或者，一次性推送全部尚未推送到远程的本地标签：
$ git push origin --tags
Counting objects: 1, done.
Writing objects: 100% (1/1), 554 bytes, done.
Total 1 (delta 0), reused 0 (delta 0)
To [email protected]:michaelliao/learngit.git
* [new tag] v0.2 -> v0.2
* [new tag] v0.9 -> v0.9