转载

转载方式： 手打
原文地址： https://github.com/wangdoc/git-tutorial
转载者： lemon

Git - 阮一峰

git是一种源码管理系统（source code managemen。缩写为SCM）。它对当前文件提供版本管理功能，核心思想是对当前文件建立一个对象数据库（object database），将历史版本信息存放在这个数据库中。

目录

• Git - 阮一峰
  • git操作流程
    • 发布一个版本
  • git对象
    • 配置
  • 目录结构
    • 缓冲区域（index）
  • Git commit的全过程
  • 父节点
  • Tag对象
  • Reference（指针）
  • 团队开发模式
  • 分支管理策略
    • github flow
    • pros and cons
    • Ruby on Rails
    • CMake
  • Git远程操作
• 分支
• git add
  • 概述
  • 参数
  • 实现细节
• git branch
  • 新建分支
  • 删除分支
  • 分支改名
  • 查看merge情况
  • 命令行参数
• git cat-file
• git checkout
  • 用来切换分支
  • 切换到指定快照（commit）
  • 将工作区指定的文件恢复到上次commit的状态
  • 切换到某个tag
  • 参数
• git cherry-pick
• git clone
• git commit-tree
• git commit
  • 命令行参数
    • -a
    • --allow-empty
    • --amend
    • --fixup
    • -m
    • --squash
• git diff
• git hash-object
• git init
• git log
  • 命令行参数
• git ls-files
• git merge
• git pull
• git rebase
  • 命令行参数
    • --autosquash
    • --continue
    • -i, --interactive
• git ref-parse
• git remote
• git reset
  • git revert
  • git rm
  • git show
  • git stash
  • git tag
  • git update-index
  • git update-ref
  • git write-tree
  • Git的操作
    • 新建代码库
    • 配置
    • 增加/删除文件
    • 代码提交
    • 分支
    • 标签
    • 查看信息
    • 远程同步
    • 撤销
    • 其他
  • 标签
    • 推送

git操作流程

• 安装git
• 提交用户名和电子邮箱

$ git config --global user.name "Some One" 
$ git config --global user.email "someone@gmail.com"

1. git init： 新建一个git库
2. git status： 查看目前状态
3. git add<文件名>： 添加文件从工作区到暂存区
4. git commit -m '提示信息'： 从暂存区提交到代码仓库
5. git log：查看提交commit的信息
6. git remote add origin https://github.com/try-git/try_git.git：添加远程指针
7. git push -u origin master：将本地的master分支推送到远程origin主机，-u参数表示记住对应关系，下次可以直接git push推送
8. git pull origin master：将远程主机origin的代码取回本地，与本地的master分支合并
9. git diff HEAD：查看上一次commit的区别

发布一个版本

为当前分支打上版本号

$ git tag -a [VERSION] -m "released [VERSION]"
$ git push origin [VERSION]

git对象

对象数据库包含四类对象。

• Blob：包含二进制数据，它们是文件内容。只要文件内容改变，就会在对象数据库中生成一个blob对象。注意，blob对象只保存文件内容，不含文件名和文件存储位置等信息。如果文件名改变，或者文件存储位置改变，不会生成新的blob对象。
• Tree：blob对象的集合，以及它们的文件名和权限。一个tree对象描述一个时点上的一个目录。
• Commit：描述一个时点上的项目状态，包含一条log信息，一个tree对象和指向父节点(parent commits)的指针。第一个commit对象没有父节点。
  • 记录root tree SHA1
  • 记录parent commit SHA1
  • 记录作者、时间和commit message资讯
• tag

对象数据库依赖SHA哈希函数。当一个对象加入数据库，它会被SHA函数处理，得到的结果就是该对象在数据库中的名字（前两个字节被当作目录名，用来提高效率）。

git命令基本上是图数据库操作命令，用来删除/操作节点、移动指针等等。

$ git init
$ echo hello > hello.txt
$ git add .
$ tree .git
# 存在 .git/objects/ce/013625030ba8dba906f756967f9e9ca394464a
# 这是hello内容的SHA1
$ printf "blob 6x00hello
" | shasum
$ echo "hello" | git hash-object-stdin
$ git cat-file -p ce0136

上面代码有几点需要注意。

• git add 命令就会生成二进制对象。
• shasum 命令返回字符串的SHA哈希函数结果。
• git hash-object 命令计算一个文件的git对象ID，stdin参数表示从标准输入读取，而不是从本地文件读取。
• git cat-file 命令显示git对象文件的内容和大小信息，p参数表示以易于阅读的格式显示。

书对象保存当前目录的快照

040000 tree 0eed1217a2947f4930583229987d90fe5e8e0b74 
data100664 blob 5e40c0877058c504203932e5136051cf3cd3519b letter.txt
100664 blob 274c0052dd5408f8ae2bc8440029ff67d79bc5c3 number.txt

commit（快照）对象也保存在‘.git/objects’目录

tree ffe298c3ce8bb07326f888907996eaa48d266db4
author Mary Rose Cook <mary@maryrosecook.com> 1424798436 -0500
committer Mary Rose Cook <mary@maryrosecook.com> 1424798436 -0500

a1

配置

指定全局的.gitgnore文件。

$ git config --global core.excludesfile=/Users/flores/.gitignore

目录结构

• .git/refs/heads：保存各个分支的指针
• .git/HEAD文件，保存HEAD指针

ref: refs/heads/master

上面代码说明HEAD指向 .git/refs/heads/master 文件，该文件是一个Hash值。

a87cc0f39d12e51be8d68eab5cef1d31e8807a1c

• .git/refs/tags：保存tag指针

缓冲区域（index）

index区域（.git/index）是一个二进制文件，用来保存当前目录再某个时点的状态。

git init 命令用来创建index区域，以及对象数据库（.dircache/objects）。

100644为档案模式，表示这是一个普通档案；100755表示可执行档，120000表示symbolic link。

.git/index 文件，保存暂存区的文件名和对应的Hash值，每行对应一个文件。下面上一个例子。

data/letter.txt5e40c0877058c504203932e5136051cf3cd3519b
data/number.txt274c0052dd5408f8ae2bc8440029ff67d79bc5c3

Git commit的全过程

1. 用内容产生 blob object
2. 写入 file mode， blob SHA1， file name 到 staging area
3. 根据 staging area 产生 Tree object
4. 用 root tree SHA1 和 parent commit SHA1 产生 commit object
5. 用 commit SHA1 更新 master 参考

如何不用 git add 和 git commit 指令完成 commit 动作？

# git add的部分

$ echo "hola" | git hash-object -w --stdin
$ git update-index --add --cacheinfo 1006445c1b14949828006ed75a3e8858957f86a2f7e2eb hola.txt

# git commit的部分

$ git write-tree
$ git commit-tree 27b9d5 -m "Second commit" -p 30b060
$ git update-ref refs/heads/master97b806c9e5561a08e0df1f1a60857baad3a1f02e

父节点

合并产生的新节点，会有两个父节点。第一个是当前所在分支的父节点，第二个合并进来的那个分支的父节点。

Tag对象

Tag 分两种： annotated tag才会产生 object

$ git tag -a release
$ git rev-parse release
$ git cat-file -p 2450f3

tag对象的内容。

object 309be0
type commit
tag release
tagger ihowe 1375383070 +0800
Realease!

Reference（指针）

所谓指针（reference），只是一个链接，用来指向其他物体，方便引用。Git有三种指针，但是所有指针归根结底都是指向某个commit。

• Tag指针：指向某个commit，或者指向某个tag对象。保存位置在.git/refs/tags/目录，文件名为tag名，内容为某个commit或ref object的SHA1哈希。
• Branch指针：指向某个commit。每次该分支有新的commit，指针就会变动。
• HEAD指针：指向目前所在Branch，用来区分目前在那个分支。比如，内容为ref： refs/heads/master。

团队开发模式

集中式工作流程：团队内部私有专案，大家都有权限Push到共用的Repository。

管理员工作流程：适合一般Open Source专案，只有少部分人有权限可以Push到Repository，其他开发者用 request pull请求合并。例如GitHub提供 Fork 和 Pull Request功能。

分支管理策略

github flow

• master是 stable/production 可部署的版本
• 任何开发从 master branch 分支出 feature branch
• 送 pull request 开始进行讨论、code review和测试
• 最后合并回master代表可以部署了

pros and cons

• 简单、清楚、容易了解
• 搭配 GitHub 的 Pull Request 界面
• 没有 release branch， 东西一进 master 就上 production

Ruby on Rails

• master 是开发版本
• feature branches 审核完毕， 合并进 master
• maintenance branches， 用 cherry-pick 做 backporting
• 基本上就是 Github flow 加上 maintenance branches 的设计
• 版本号（Tag）打在master上，透过perview和beta的版本号提前释出

CMake

• master预备释出的版本，feature branches从这里分支出去。
• feature branch 完成后，合并进next
• next 整合版本，完成的feature branch 先合并到这里进行测试
  • 在next测好的feature branch，才合并进 master
  • 可以将 master 合并进 next， 减少之后的 code conflicts
  • 不会将 next 合并进 master
• nightly 每天 1：UTC 自动从 next branch 分支出来跑自动测试。

Git远程操作

Git 的repo一般是用来指本地库， 远程库（remote）主要用来存档、合作、分享和出发持续集成。

分支

分支是 Git 最重要的概念之一，也是最常用的操作之一。几乎所有 Git 操作流程都离不开分支。

git branch 命令可以列出本地的所有分支。

$ git branch

创建一个名为 MyBranch 的新分支，但是依然停留在当前分支。

$ git branch MyBranch

在远程主机 origin 上创建一个 MyBranch 的分支，并于本地的同名分支建立追踪关系。

$ git push -u origin MyBranch

将当前分支改名为 MyBranch

$ git branch -m MyBranch

删除 MyBranch 分支，前提是该分支没有未合并的变动。

$ git branch -d MyBranch

强制删除 MyBranch 分支，不管有没有未合并变化。

$ git branch -D MyBranch

切换到 MyBranch 分支，当前的工作区会变为 MyBranch 分支的内容。

$ git checkout MyBranch

基于 MyBranch 分支创建一个新的 NewBranch 分支， 新的 NewBranch 分支将成为当前的工作区。

$ git checkout -b NewBranch MyBranch

git add

概述

git add 命令用于将变化的文件，从工作区提交到暂存区。它的作用就是告诉Git， 下一次那些变化需要保存到仓库区。用户可以使用 git status 命令查看目前的暂存区放置了那些文件。

# 将指定文件放入暂存区
$ git add <file>

# 将指定目录下所有变化的文件，放入暂存区
$ git add <directory>

# 将当前目录下所有变化的文件，放入暂存区
$ git add .

参数

-u 参数表示只添加暂存区已有的文件（包括删除操作），但不添加新增的文件。

$ git add -u

-A 或者 --all 参数表示追踪所有操作，包括新增、修改和删除。

$ git add -A

Git 2.0版开始， -A参数成为默认，即 git add . 等同于 git add -A。

-f 参数表示强制添加某个文件，不管 .gitignore 是否包含了这个文件。

$ git add -f <fileName>

-p 参数表示进入交互模式，指定那些修改需要添加到暂存区。即使是同一个文件，也可以只提交部分变动。

$ git add -p

注意，Git 2.0 版以前， git add 默认不追踪删除操作。即在工作区删除一个文件后， git add 命令不会将这个变化提交到暂存区， 导致这个文件继续存在于历史中。Git 2.0 改变了这个行为。

实现细节

通过 git add 这个命令，工作区里面那些新建或修改过的文件，会加入 .git/objects/ 目录，文件名是文件内容的SHA1哈希值。 git add 命令同时还将这些文件名和对应的哈希值， 写入 .git/index 文件， 每一行对应一个文件。

下面是 .git/index 文件的内容。

data/letter.txt 5e40c0877058c504203932e5136051cf3cd3519b

上面代码表示，data/letter.txt 文件的哈希值是 5e40c087... 。可以根据这个哈希值到 .git/objects/ 目录下找到添加后的文件。

git branch

git branch 是分支操作命令。

# 列出所有本地分支
$ git branch

# 列出所有本地分支和远程分支
$ git branch-a

新建分支

直接在 git branch 后面跟上分支名， 就表示新建该分支。

$ git branch develop

新建一个分支，指向当前commit。本质是在 refs/heads/ 目录中生成一个文件，文件名为分支名，内容为当前commit的哈希值。

注意，创建后，还是停留在原来分支，需要用 git checkout 切换到新建分支。

$ git checkout develop

使用 -b 参数，可以新建的同时，切换到新分支。

$ git checkout -b NewBranch MyBranch

删除分支

-d 参数用来删除一个分支，前提是该分支没有未合并的变动。

$ git branch -d <分支名>

强制删除一个分支，不管有没有未合并变化。

$ git branch -D <分支名>

分支改名

$ git checkout -b twitter-experiment feature132
$ git branch -d feature132

另一种写法

# 为当前分支改名
$ git branch -m twitter-experiment

# 为指定分支改名
$ git branch -m feature132 twitter-experiment

# 如果有重名分支，强制改名
$ git branch -m feature132 twitter-experiment

查看merge情况

# Show branches that are all merged in to your current branch
$ git branch --merged

# Show branches that are not merged in to your current branch
$ git branch --no-merged

命令行参数

-d 参数用于删除一个指定分支

$ git branch -d <branchname>

git cat-file

git cat-file 命令显示一个Git对象文件的内容

$ git cat-file -p aaa96

p 参数表示以易于阅读的格式显示。

git checkout

git checkout 命令有多种用途。

用来切换分支

$ git checkout

上面命令表示回到先前所在的分支。

$ git checkout develop

上面命令表示切换到 develop 分支。

切换到指定快照（commit）

$ git checkout <commitID>

将工作区指定的文件恢复到上次commit的状态

# 将指定文件从暂存区复制到工作区
# 用来丢弃工作区对该文件的修改
$ git checkout -- <filename>

# 还可以从指定某个 commit 恢复指定文件
# 这会同时改变暂存区和工作区
$ git checkout HEAD~ --<filename>

-p 参数表示进入交互模式，只恢复部分变化。

$ git checkout -p

切换到某个tag

$ git checkout tags/1.1.4
# 或者
$ git checkout 1.1.4

上面第二种用法的前提是，本地不能又叫做1.1.4的分支。

参数

-b 用于生成一个新的分支。

$ git checkout -b new

git cherry-pick

git cherry-pick 命令“复制”一个提交节点并在当前分支做一次完全一样的新提交。

$ git cherry-pick 2c33a

git clone

git clone 命令用于克隆远程分支。

$ git clone alpha delta --bare

上面命令表示将alpha目录（必须是git代码仓库），克隆到delta目录。bare参数表示delta目录只有仓库区， 没有工作区和暂存区， 即delta目录中就是.git目录的内容。

git commit-tree

根据一个树对象，生成新的commit对象。

$ git commit-tree 16e19f -m"First commit"

git commit

git commit 命令用于将暂存区中的变化提交到仓库区。
-m 参数用于指定 commit 信息，是必需的。如果省略 -m 参数， git commit 会自动打开文本编辑器，要求输入。

$ git commit -m "message"

git commit 命令可以跳过暂存区，直接将文件从工作区提交到仓库区。

$ git commit <filename> -m "message"

上面命令会将工作区中指定文件的变化，先添加到暂存区，然后再将暂存区提交到仓库区。

命令行参数

-a

-a 参数用于先将所有工作区的变动文件，提交到暂存区，再运行 git commit。用了 -a 参数，就不用执行git add . 命令了。

$ git commit -am "message"

如果没有指定提交说明，运行下面的命令会直接打开默认的文本编辑器，让用户撰写提交说明。

$ git commit -a

--allow-empty

--allow-empty 参数用于没有提交信息的commit

$ git commit --allow-empty

--amend

--amend 参数用于撤销上一次commit，然后生成一个新的commit。

$ git commit --amend -m "new commit message"

--fixup

--fixup 参数的含义是，当前添加的commit是以前某一个commit的修正。以后执行互动式的 git rebase 的时候，这两个 commit 将会合并成一个。

$ git commit --fixup <commit>

执行上面的命令，提交说明即将自动生成，即再目标 commit 的提交说明的最前面， 添加 ‘fixup’这个词。

-m

-m 参数用于添加提交说明

$ git commit -m "message"

--squash

--squash 参数的作用与 --fixup 类似，表示当前添加的 commit 应该与以前某一个 commit 合并成一个，以后执行互动式的 git rebase 的时候， 这两个 commit 将会合并成一个。

$ git commit --squash <commit>

git diff

git diff 命令用于查看文件之间的差异。

# 查看工作区与暂存区的差异
$ git diff

# 查看某个文件的工作区与暂存区的差异
$ git diff file.txt

# 查看暂存区与当前 commit 的差异
$ git diff --cached

# 查看两个commit的差异
$ git diff <commitBefore> <commitAfter>

# 查看暂存区和仓库区的差异
$ git diff --cached

# 查看工作区与上一次commit之间的差异
# 即如果执行 git commit -a， 将提交的文件
$ git diff HEAD

# 查看工作区与某个commit的差异
$ git diff <commit>

# 显示两次提交之间的差异
$ git diff [first-branch] ... [second-branch]

# 查看工作区与当前分支上一次提交的差异，但是局限于test文件
$ git diff HEAD -- ./test

# 查看当前分支上一次提交与上上一次提交之间的差异
$ git diff HEAD -- ./test

# 生成patch
$ git format-patch master --stdout > mypatch.patch

比较两个分支

# 查看topic分支与master分支最新提交之间的差异
$ git diff topic master

# 与上一条命令相同
$ git diff topic。。master

# 查看自从topic分支建立以后，master分支发生的变化
$ git diff topic。。。master

git hash-object

git hash-object 命令计算一个文件的git对象ID，即SHA1的哈希值。

$ echo "hello" | git hash-object --stdin
$ echo "holla" | git hash-object -w --stdin

参数

• w 将对象写入对象数据库
• stdin 表示从标准输入读取，而不是从本地文件读取。

git init

git init 命令将当前目录转为git仓库
它会在当前目录下生成一个.git子目录，在其中写入git的配置和项目的快照。

git log

git log 命令按照提交时间从最远到最早的顺序，列出所有 commit。

# 列出当前分支的版本历史
$ git log

# 列出某个文件的版本历史，包括文件改名
$ git log --follow [file]

查看远程分支的变动情况。

$ git log remote/branch

查找log，即搜索commit信息。

$ git log --author=Andy
$ git log -i --grep= "Something in the message"

上面代码中， -i 参数表示搜索时忽略大小写。

查看某个范围内的commit

$ git log origin/master。。new
# [old]。。[new] - everything you haven't pushed yet

类似输出

git log --graph --decorate --pretty-oneline --abbrev-commit

• --graph commit之间将展示连线
• --decorate 显示commit里面的分支
• --pretty=oneline 只显示commit信息的标题
• --abbrev-commit 只显示commit SHA1的前7位

命令行参数

--oneline
git log 默认输出每个 commit 的详细信息，为了节省空间， --oneline 参数让输出时， 每个 commit 只占用一行。

$ git log --oneline --decorate
ccc333 (HEAD, my-feature-branch) A third commit
bbb222 A second commit
aaa111 A first commit
9999999 (master) Old stuff on master

git ls-files

# 列出没有被.gitignore忽视的文件
$ git ls-files --other --ignored --exclude-standard

git merge

将当前分支合并到指定分支。

$ git merge develop

将当前分支与develop分支合并，产生的新的commit对象有两个父节点。

如果“指定分支”本身是当前分支的一个直接子节点，则会产生fast-forward合并，即合并不会产生新的节点，只是让当前分支指向“指定分支”的最新commit。

Git合并所采用的方法是Three-way merge，及合并的时候除了要合并的两个档案，还加上它们共同的父节点。这样可以大大减少人为处理conflict的情况。如果采用two-way merge，则只用两个档案进行合并（svn默认就是这种合并方法）。

git pull

# 合并指定分支到当前分支
$ git pull . topic/branch

即使当前分支没有commit的变动，也可以使用 git pull 从远程拉取分支。

git rebase

git rabase 将当前分支移植到指定分支或指定commit上。

$ git rebase -i <commit>

互动的rebase。

$ git rebase -i master~3

命令行参数

--autosquash

--autosquash 参数用于互动模式。必须与-i参数配合使用。它会使得以前通过 git commit --fixup 和 git commit --squash 提交的 commit， 按照指定的顺序排列（实质是选择提交说明以 fixup ! 或 squash！ 开头的commit），即 --fixup 的commit直接排在它所对应的 commit的后面。

$ git rabase --interactive --autosquash <branch>

--continue

--continue 参数用于解决冲突以后，继续执行rebase。

$ git rebase --continue

-i, --interactive

-i 参数会打开互动模式，让用户选择定制 rebase 的行为。

$ git rabse -i develop

git ref-parse

显示某个指示符的SHA1哈希值。

$ git ref-parse HEAD

git remote

未远程仓库添加别名。

$ git remote add john git@github.com: johnsomeone/someproject.git

# 显示所有的远程主机
$ git remote -v

# 列出某个主机的详细信息
$ git remote show name

git remote 命令实质是在 .git/config 文件下添加下面的内容

$ git remote add bravo ../bravo

[remote "bravo"]
    url = ../bravo

git reset

git reset 命令用于将当前分支指向另一个位置。

# 将当前分支的指针倒退三个 commit
# 并且会更改暂存区
$ git reset HEAD~3

# 倒退指针的同时，不改变暂存区
$ git reset --soft HEAD~3

# 倒退指针的同时，改变工作区
$ git rest --hard HEAD~3

如果不指定回滚的位置，那么等同于撤销修改。

# 撤销上一次向暂存区添加的所有文件
$ git reset

# 无任何效果
$ git reset  --soft

# 同时撤销暂存区和工作区的修改，
# 回复到上一次提交的状态
$ git reset --hard


# 撤销上一次向暂存区添加的某个指定文件，
# 不影响工作区中的该文件
$ git reset --- <filename>

参数

• soft：不改变工作区和缓存区，只移动HEAD到指定commit。
• mixed：只改变缓存区，不改变工作区。这是默认参数，通常用于撤销 git add。
• hard： 改变工作区和暂存区到指定commit。该参数等同于重置，可能会引起数据损失。 git reset --hard 等同于 git reset --hard HEAD
• -p 表示键入交互模式，指定暂存区的那些部分需要撤销。

# Undo add
$ git reset

# Undo a commit，不重置工作区和缓存区
# 回到 HEAD 之前的那个 commit
$ git reset --soft HEAD^

# Undo a commit，重置工作区和缓存区
# 连续撤销三个 commit: HEAD, HEAD^, and HEAD~2
$ git reset --hard HEAD^3

# 从暂存区移除指定文件，但不改变工作区中的该文件
$ git reset -- frotz.c

git revert

git revert 命令用于撤销 commit。

$ git revert <commitID>

git rm

gir rm 命令用于删除文件。
接触追踪某个文件，即该文件已被 git add 添加，然后抵消这个操作。

$ git rm --cached <fileName>

git show

git show 命令用于查看commit的内容

# 输出某次提交的元数据和内容变化
$ git show [commit]

$ git show 12a86bc38 # By revision
$ git show v1.0.1 # By tag
$ git show feature132 # By branch name
$ git show 12a86bc38^ # Parent of a commit
$ git show 12a86bc38~2 $ Grandparent of a commit
$ git show feature132@{yesterday} # Time relative
$ git show feature132@{2.hours.ago} # Time relative

git stash

git stash 命令用于暂时保存没有提交的工作。运行该命令后，所有没有commit的代码，都会暂时从工作区移除，回到上次commit时的状态。

它处于 git reset --hard （完全放弃还修改了一半的代码）与 git commit （提交代码） 命令之间，很类似于“暂停”按钮。

# 暂停保存没有提交的工作
$ git stash
Saved working directory and index state WIP on workbranch: 56cd5d4 Revert "update old files"
HEAD is now at 56cd5d4 Revert "update old files"

# 列出所有暂时保存的工作
$ git stash list
stash@{0}: WIP on workbranch: 56cd5d4 Revert "update old files"
stash@{1}: WIP on project1: 1dd87ea commit "fix typos and grammar"

# 恢复某个暂时保存的工作
$ git stash apply stash@{1}

# 恢复最近一次stash的文件
$ git stash pop

# 丢弃最近一次stash的文件
$ git stash drop

# 删除所有的stash
$ git stash clear

上面命令会将所有已提交到暂存区，以及没有提交的修改，都进行内部保存，将工作区恢复到上一次commit的状态。

使用下面的命令，取回内部保存的变化，他会与当前工作区的代码合并。

$ git stash pop

这时，如果与当前工作区的代码有冲突，需要手动调整。
git stash 命令可以运行多次，保存多个未提交的修改。这些修改以“先进后出”的stack结构保存。

git stash list 命令查看内部保存的多词修改。

$ git stash list
stash@{0}: WIP on new-feature: 5cedccc Try something crazy
stash@{1}: WIP on new-feature: 9f44b34 Take a different direction
stash@{2}: WIP on new-feature: 5acd291 Begin new feature

上面命令假设曾经运行过 git stash 命令三次。
git stash pop 命令总是取出最近一次的修改，但是可以用 git stash apply 指定取出某一次的修改。

$ git stash apply stasj@{1}

上面命令不会自动删除取出的修改，需要手动删除。

$ git stash drop stash@{1}

git stasj子命令一览。

# 展示目前存在的stash
$ git stash show -p

# 切回stash
$ git stash pop

# 清除stash
$ git stash clear

git tag

git tag 命令用于未 commit 打标签。 Tag 分两种： 普通tag和注解tag。只有annotated tag才会产生object。

$ git tag tmp # 生成.git/refs/tags/tmp
$ git tag -a release 
$ git tag -a [VERSION] -m "released [VERSION]"

上面代码表示位当前commit打上一个带注解的标签，标签名位release。

普通标签的写法。

$ git tag 1.0.0
$ git push --tags

$ git tag v0.0.1
$ git push origin master --tags

git update-index

将工作区的文件加入缓存区域。

$ git update-index --add --cacheinfo 
100644 5c1b14949828006ed75a3e8858957f86a2f7e2eb hola.txt

git update-ref

git update-ref 命令用于更新一个指针文件中的Git对象ID。

$ git update-ref refs/heads/master 107aff

git write-tree

git write-tree 命令用于根据当前缓存区域，生成一个树对象。

$ git write-tree

Git的操作

新建代码库

# 在当前目录新建一个Git代码库
$ git init

# 新建一个目录，将其初始化为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]"

增加/删除文件

# 添加指定文件到暂存区
$ git add [file1] [file2] ...

# 添加指定目录到暂存区，包括子目录
$ git add [dir]

# 添加当前目录的所有文件到暂存区
$ git add .

# 删除工作区文件，并且将这次删除放入暂存区
$ git rm [file1] [file2] ...

# 停止追踪指定文件，但该文件会保留在工作区
$ git rm --cached [file]

# 改名文件，并且将这个改名放入暂存区
$ git mv [file-original] [file-renamed]

代码提交

# 提交暂存区到仓库区
$ 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 -b [branch]

# 新建一个分支，指向指定commit
$ git branch [branch] [commit]

# 新建一个分支，与指定的远程分支建立追踪关系
$ git branch --trach [branch] [remote-branch]

# 切换到指定分支，并更新工作区
$ git checkout [branch-name]

# 建立追踪关系，在现有分支与指定的远程分支之间
$ 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>

标签

# 列出所有tag
$ git atg

# 新建一个tag在当前commit
$ git tag [tag]

# 新建一个tag在指定commit
$ git tag [tag] [commit]

# 查看tag信息
$ git show [tag]

# 提交指定tag
$ git push [remote] [tag]

# 提交所有tag 
$ git oush [remote] --tags

# 新建一个分支，指向某个tag
$ git checkout -b [branch] [tag] 

查看信息

# 显示有变更的文件
$ git status

# 显示当前分支的版本历史
$ git log

# 显示commit历史，以及每次commit发生变更的文件
$ git log --stat

# 显示某个文件的版本历史，包括文件改名
$ git log --follow [file]
$ git whatchanged [file]

# 显示指定文件相关的每一次diff
$ git log -p [file]

# 显示指定文件是什么人在什么时候修改过
$ git blame [file]

# 显示暂存区和工作区的差异
$ git diff

# 显示暂存区和上一个commit的差异
$ git diff --cached [<file>]

# 显示工作区与当前分支最新commit之间的差异
$ git diff HEAD

# 显示两次提交之间的差异
$ git diff [first-branch] ... [second-branch]

# 显示某次提交的元数据和内容变化
$ 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] --force

# 推送所有分支到远程仓库
$ git push [remote] --all

撤销

# 恢复暂存区的指定文件到工作区
$ git checkout [file]

# 恢复某个commit的指定文件到工作区
$ git checkout [commit] [file]

# 恢复上一个commit的所有文件到工作区
$ git checkout .

# 重置暂存区的指定文件，与上一次commit保持一致，但工作区不变
$ git reset [file]

# 重置暂存区与工作区，与上一次commit保持一致
$ git reset --hard

# 重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变
$ git reset [commit]

# 重置当前分支的HEAEAD为指定commit，同时重置暂存区和工作区，与指定commit一致
$ git reset --hard [commit]

# 重置当前HEAD为指定commit，但保持暂存区和工作区不变
$ git reset --keep [commit]

# 新建一个commit，用来撤销指定commit
# 后者的所有变化都将被前者抵消，并且应用到当前分支
$ git revert [commit]

其他

# 生成一个可供发布的压缩包
$ git archive

标签

推送

标签必须单独推送。也就是说，git push 命令默认不会推送标签， 必须使用 --tags 参数。

$ git push && git push --tags

上面的命令先推送新的commit，成功后在单独推送标签。

--follow-tags 参数会使得commit以及与之相关的标签（注意，不是所有的标签）一起推送。

$ git push --follow-tags

Git 有一个对应于 --follow-tags 的配置项，默认是关闭得。如果将他打开，以后执行 git push 的时候，默认就会带上 --follow-tags。

$ git config --global push.followTags true