Git 命令

设置账号信息

全局配置

# 设置
git config --global user.name wind-stone
git config --global user.email wind-stone@qq.com

# 查看
git config --global user.name
git config --global user.email

1
2
3
4
5
6
7

本地（项目）

# 设置
git config user.name wind-stone
git config user.email wind-stone@qq.com

# 查看
git config user.name
git config user.email

1
2
3
4
5
6
7

分支

创建分支

git branch dev-branch

（在当前 HEAD 指向的提交对象上）创建新的分支 dev-branch

检出分支

git checkout dev-branch

切换到（已存在的）dev-branch 分支上。这条命令做了两件事。

使 HEAD 指回 dev-branch 分支
将工作目录恢复成 dev-branch 分支所指向的快照内容。

创建分支并检出

git checkout -b dev-branch

等同于
git branch dev-branch
git checkout dev-branch

1
2
3
4
5

（在当前 HEAD 指向的提交对象上）创建新的分支 dev-branch，并切换到 dev-branch。

合并分支

git merge dev-branch

将 dev-branch 合并到当前所在分支（合并以后，当前分支指向新的提交，dev-branch 指向的提交不变）

squash 参数

git checkout master

git merge --squash bugfix

git commit

1
2
3
4
5

以上面的命令为例，--squash参数是将bugfix上（与master不同的）所有提交压缩到一起放置在master分支上的暂存区。尤其需要注意，此时bugfix上的所有修改（这些修改可能来自于bugfix上的多个提交）只是放在暂存区，但并没有提交这些修改。

再通过git commit提交所有暂存区的修改，生成master分支上的一个新的提交。

最终的效果是，master分支合并了bugfix分支上的所有修改，并最终在master分支上只生成了一个新的提交。

PS：bugfix分支不会出现任何变化。

删除分支

git branch -d dev-branch

删除 dev-branch 分支

查看分支

git branch
  iss53
* master
  testing

1
2
3
4

注意 master 分支前的 * 字符：它代表现在检出的那一个分支（也就是说，当前 HEAD 指针所指向的分支）

git branch -v
  iss53   93b412c fix javascript issue
* master  7a98805 Merge branch 'iss53'
  testing 782fd34 add scott to the author list in the readmes

1
2
3
4

查看每一个分支及其最后一次提交

git branch --merged

查看哪些分支已经合并到当前分支

git branch --no-merged

查看所有包含未合并工作的分支

查找丢失的 commit 或 branch

git log和git reflog的区别（详见Stack Overflow - What's the difference between git reflog and log?open in new window）：

git log shows the current HEAD and its ancestry. That is, it prints the commit HEAD points to, then its parent, its parent, and so on. It traverses back through the repo's ancestry, by recursively looking up each commit's parent.
(In practice, some commits have more than one parent. To see a more representative log, use a command like git log --oneline --graph --decorate.)
git reflog doesn't traverse HEAD's ancestry at all. The reflog is an ordered list of the commits that HEAD has pointed to: it's undo history for your repo. The reflog isn't part of the repo itself (it's stored separately to the commits themselves) and isn't included in pushes, fetches or clones; it's purely local.
Aside: understanding the reflog means you can't really lose data from your repo once it's been committed. If you accidentally reset to an older commit, or rebase wrongly, or any other operation that visually "removes" commits, you can use the reflog to see where you were before and git reset --hard back to that ref to restore your previous state. Remember, refs imply not just the commit but the entire history behind it.

因此，git reflog命令显示的是个顺序列表，列表里的每一项都是 HEAD 曾经指向的提交，包括已经丢失的提交，因此当你意外地重置到一个更早的提交，或者错误的变基，或者其他任何操作导致一些提交丢失，你都可以使用git reflog查看 HEAD 曾经所在的提交，并使用git reset --hard来恢复到你之前的状态上。

操作步骤：

$ git reflog
# 以下是 HEAD 曾经所处的提交，现在假设想恢复到“740692f HEAD@{5}: commit: feat(命名规范): js 命名规范”这个提交
fb7a578 (HEAD -> master, origin/master, origin/HEAD) HEAD@{0}: pull origin master: Fast-forward
db9198d HEAD@{1}: reset: moving to head~1
fb7a578 (HEAD -> master, origin/master, origin/HEAD) HEAD@{2}: reset: moving to HEAD
fb7a578 (HEAD -> master, origin/master, origin/HEAD) HEAD@{3}: commit: docs: update
db9198d HEAD@{4}: commit: docs: update
740692f HEAD@{5}: commit: feat(命名规范): js 命名规范
bb9c824 HEAD@{6}: commit: docs: update
4590770 HEAD@{7}: commit: feat(mvvm): 添加 virtual dom 相关
43e5b1c HEAD@{8}: commit: feat(webpack): preload & prefetch

$ git reset --hard 740692f
# 恢复完成，现在 HEAD 就会处于“740692f HEAD@{5}: commit: feat(命名规范): js 命名规范”这个提交了

1
2
3
4
5
6
7
8
9
10
11
12
13
14

远程仓库

查看

git remote

列出指定的每一个远程服务器的简写

git remote -v

指定选项 -v，会显示需要读写远程仓库使用的 Git 保存的简写与其对应的 URL

git remote show origin

查看远程仓库 origin 的详细信息

添加

git remote add pb https://github.com/paulboone/ticgit

添加新的远程仓库，地址为https://github.com/paulboone/ticgit，并指定其引用的简写为 pb

重命名

git remote rename origin github-origin

将远程仓库 origin 重命名为 github-origin

移除

git remote rm origin

移除远程仓库 origin

抓取远程仓库数据

git fetch origin

抓取远程仓库 origin 的数据到本地（但不会在本地生成可编辑的副本，也不会合并数据到本地分支）

git fetch --all

抓取所有的远程仓库的数据到本地

合并远程分支

git merge origin/dev-branch

合并远程仓库 origin 的 dev-branch 分支到当前所在分支

创建并检出远程分支的本地分支

git checkout -b dev-branch origin/dev-branch

创建远程仓库 origin 的 dev-branch 分支的本地副本分支，并检出（切换）到该分支

（注意：此时本地没有 dev-branch 分支，且本地分支创建后，会自动追踪远程分支）

推送分支

git push 命令

# 将本地 local-branch 推动到 origin 远程仓库的 server-branch 分支上
# 若 origin 远程仓库不存在 server-branch 分支，则会新创建 server-branch 分支
#
# 通过这种方式，可以将本地分支推动到远程仓库的一个命名不相同的远程分支
# PS: 执行该命令时，可以处于本地的任意分支，不一定要在 local-branch 分支上
git push origin local-branch:server-branch

1
2
3
4
5
6

git push origin master
# 等同于
git push origin master:master

1
2
3

省略远程仓库名称

# 将本地当前分支推送到 origin 远程仓库的同名分支上
git push origin

# 若本地当前分支只追踪了一个远程仓库的分支，则可以省略远程仓库的名称 origin
git push

1
2
3
4
5

省略分支名称

若执行的命令是在本地example-branch分支上，且要推动origin远程仓库的example-branch分支上，且本地example-branch分支已经追踪了origin/example-branch分支，则在执行git push相关命令时，可以省略分支名称。

选项

--set-upstream

# 将本地 master 分支推动到 origin 远程仓库 master 分支
# 同时指定 origin 为默认远程仓库，以后就可以不加任何参数使用 git push 了
git push --set-upstream origin master
# 简写
git push -u origin master

1
2
3
4
5

--all

# 将所有本地分支都推送到 origin 远程仓库的同名分支上
git push --all origin

1
2

--force

# 强制推送，会覆盖远程分支的提交
git push --force origin
# 简写
git push -f origin

1
2
3
4

--tags

git push命令不会推送标签（tag），除非使用--tags选项。

git push --tags
git push origin --tags

1
2

追踪分支

从一个远程跟踪分支检出一个本地分支会自动创建一个叫做 “跟踪分支”（有时候也叫做 “上游分支”）。跟踪分支是与远程分支有直接关系的本地分支。

git checkout -b dev-branch origin/dev-branch

# 快捷方式
git checkout --track origin/dev-branch

1
2
3
4

检出远程分支并追踪

git checkout -b local-branch origin/server-branch

检出远程分支并追踪，如果想将本地分支设置为不同于远程分支的名称

git branch -u origin/dev-branch

设置已有的本地分支跟踪一个刚刚拉取下来的远程分支，或者想要修改正在跟踪的上游分支，你可以在任意时间使用 -u 或 --set-upstream-to 选项运行 git branch 来显式地设置

git branch -vv
  iss53     7e424c3 [origin/iss53: ahead 2] forgot the brackets
  master    1ae2a45 [origin/master] deploying index fix
* serverfix f8674d9 [teamone/server-fix-good: ahead 3, behind 1] this should do it
  testing   5ea463a trying something new

1
2
3
4
5

查看设置的所有跟踪分支，需要重点注意的一点是这些数字的值来自于你从每个服务器上最后一次抓取的数据

拉取远程分支

git pull

当 git fetch 命令从服务器上抓取本地没有的数据时，它并不会修改工作目录中的内容。它只会获取数据然后让你自己合并。然而，有一个命令叫作 git pull 在大多数情况下它的含义是一个 git fetch 紧接着一个 git merge 命令。如果有一个像之前章节中演示的设置好的跟踪分支，不管它是显式地设置还是通过 clone 或 checkout 命令为你创建的，git pull 都会查找当前分支所跟踪的服务器与分支，从服务器上抓取数据然后尝试合并入那个远程分支。

由于 git pull 的魔法经常令人困惑所以通常单独显式地使用 fetch 与 merge 命令会更好一些。

删除远程分支

git push origin --delete dev-branch

删除远程仓库 origin 上的 dev-branch 分支

变基

git checkout dev-branch
git rebase master

1
2

将当前分支 dev-branch 变基到 master 分支

git rebase master dev-branch

也可以省去 git checkout dev-branch 操作，直接如上进行变基。

通俗些理解，变基的意思就是：

假设 dev-branch 和 master 共同的祖先提交对象是 Cc，将 dev-branch 基于 Cc 进行的修改提取出来并应用到 master 的当前提交对象 Cm 上，使其在历史提交记录上看起来，这些修改是基于 Cm 进行的而不是基于 Cc 进行的。

一般我们这样做的目的是为了确保在向远程分支推送时能保持提交历史的整洁——例如向某个其他人维护的项目贡献代码时。在这种情况下，你首先在自己的分支里进行开发，当开发完成时你需要先将你的代码变基到 origin/master 上，然后再向主项目提交修改。这样的话，该项目的维护者就不再需要进行整合工作，只需要快进合并便可。

风险

变基也并非完美无缺，要用它得遵守一条准则：

不要对在你的仓库外有副本的分支执行变基。

储藏

储藏文件

git stash
git stash save

1
2

上面两条命令是等价的，储藏工作目录里的以下文件

处于已修改状态的已跟踪文件
已经暂存的文件

查看储藏

git stash list

应用储藏

注意：可以在一个分支上保存一个储藏，切换到另一个分支，然后尝试重新应用这些修改

git stash apply

应用最近的储藏，储藏还在堆栈上，不会自动移除

git stash apply stash@{2}

应用指定的储藏

git stash apply --index

应用储藏后，之前暂存的文件没有重新暂存，如果想要重新暂存，带上 --index

git stash pop

应用最近的储藏，并将储藏从堆栈上移除

git stash drop stash@{2}

应用指定的储藏，并将储藏从堆栈上移除

git stash --keep-index

添加 --keep-index 选项，它告诉 Git 不要储藏任何你通过 git add 命令已暂存的东西

git stash -u

指定 --include-untracked 或 -u 标记，Git 也会储藏任何创建的未跟踪文件

git stash --patch

如果指定了 --patch 标记，Git 不会储藏所有修改过的任何东西，但是会交互式地提示哪些改动想要储藏、哪些改动需要保存在工作目录中

git stash branch testchanges

创建新的分支 testchanges，并应用储藏

清理工作目录

git clean

从工作目录中移除未被追踪的文件

git stash --all

移除每一样东西并存放在栈中

git clean -f -d

移除工作目录中所有未追踪的文件以及空的子目录。 -f 意味着强制或 “确定移除”

git clean -d -n
  Would remove test.o
  Would remove tmp/

1
2
3

如果只是想要看看它会做什么，可以使用 -n 选项来运行命令，这意味着 “做一次演习然后告诉你将要移除什么”

git clean -n -d
  Would remove build.TMP
  Would remove tmp/

git clean -n -d -x
  Would remove build.TMP
  Would remove test.o
  Would remove tmp/

1
2
3
4
5
6
7
8

默认情况下，git clean 命令只会移除没有忽略的未跟踪文件。任何与 .gitiignore 或其他忽略文件中的模式匹配的文件都不会被移除。如果你也想要移除那些文件，例如为了做一次完全干净的构建而移除所有由构建生成的 .o 文件，可以给 clean 命令增加一个 -x 选项。

如果不知道 git clean 命令将会做什么，在将 -n 改为 -f 来真正做之前总是先用 -n 来运行它做双重检查。

检查修改、撤销操作

执行撤销操作之前，先了解下如何检查已经做出的修改。

检查修改

【已修改，未暂存】检查已修改文件与该文件未修改时的差异，即检查工作区文件与本地仓库文件之间的差异

# 查看全部
git diff
git diff .
# 查看单个文件
git diff xxx.md

1
2
3
4
5

【已暂存，未提交】检查已暂存文件与该文件之前已提交时文件的差异，即检查暂存区文件与本地仓库文件之间的差异

# 查看全部
git diff --cached
git diff --cached .
# 查看单个文件
git diff --cached xxx.md

1
2
3
4
5

【已提交，未推送】检查已提交文件与远程仓库里该文件的差异，即检查本地仓库文件与远程仓库文件之间的差异

# 查看全部
git diff master origin/master --cached
git diff master origin/master --cached .
# 查看单个文件
git diff master origin/master --cached xxx.md

1
2
3
4
5

提示：执行 git diff 命令后，按键入 q 返回

撤销操作

已修改，未暂存

# 全部撤销
git checkout .
# 单个撤销
git checkout xxx.md

1
2
3
4

或者

# 全部撤销
git reset --hard

1
2

已暂存，未提交

git reset
git checkout .

1
2

或

git reset --hard

git reset将暂存区的文件重置到 git add 之前的状态，即文件本身还处于已修改但未暂存的状态，如果需要退回到未修改状态，还需要执行git checkout命令。

git reset的使用方法：

# 全部
git reset
git reset .
# 单个
git reset xxx.md

1
2
3
4
5

此外， git reset -—hard这个命令，可以一步到位地把已暂存文件完全恢复到未修改的状态。

已提交，未推送

git reset --hard origin/master

已推送

git reset --hard HEAD^
git push -f

1
2

git reset 命令

假设当前所在提交为currentCommit。

暂存区：通过git add提交，即进去暂存区。工作区：已修改/添加/删除，但未通过git add提交。

git reset --hard
git reset --hard `某次提交 A 的 hash 值`

1
2

将head重置到某一次的提交A，则

工作目录改变：当前工作目录里所有暂存区里（包括修改后暂存和删除后暂存）的文件、工作区里（已修改/删除但未暂存）的文件将全部丢失，但是工作区里新增（但未暂存）的文件保留下来不会丢失
自提交A到提交currentCommit里所有的提交都将丢失，工作目录恢复到提交A

git reset --soft
git reset --soft 某次提交A的hash值

1
2

将 head 重置到某一次的提交A，且：

工作目录不变：原先在暂存区的还在暂存区，在工作区的还在工作区
自提交A到提交currentCommit里所有的文件修改都放在暂存区，不会丢失

git reset --mixed
git reset --mixed 某次提交A的hash值

1
2

将 head 重置到某一次的提交A，且：

工作目录不变：原先在工作区的还在工作区，原先在暂存区的会被移到工作区
自提交A到提交currentCommit里所有的文件修改都放在工作区（未暂存），不会丢失

Reference:

# Git 命令

# 设置账号信息

# 分支

# 创建分支

# 检出分支

# 创建分支并检出

# 合并分支

# squash 参数

# 删除分支

# 查看分支

# 查找丢失的 commit 或 branch

# 远程仓库

# 查看

# 添加

# 重命名

# 移除

# 抓取远程仓库数据

# 合并远程分支

# 创建并检出远程分支的本地分支

# 推送分支

# git push 命令

# 省略远程仓库名称

# 省略分支名称

# 选项

# --set-upstream

# --all

# --force

# --tags

# 追踪分支

# 拉取远程分支

# 删除远程分支

# 变基

# 风险

# 储藏

# 储藏文件

# 查看储藏

# 应用储藏

# 清理工作目录

# 检查修改、撤销操作

# 检查修改

# 撤销操作

# 已修改，未暂存

# 已暂存，未提交

# 已提交，未推送

# 已推送

# git reset 命令

Git 命令

设置账号信息

分支

创建分支

检出分支

创建分支并检出

合并分支

squash 参数

删除分支

查看分支

查找丢失的 commit 或 branch

远程仓库

查看

添加

重命名

移除

抓取远程仓库数据

合并远程分支

创建并检出远程分支的本地分支

推送分支

git push 命令

省略远程仓库名称

省略分支名称

选项

--set-upstream

--all

--force

--tags

追踪分支

拉取远程分支

删除远程分支

变基

风险

储藏

储藏文件

查看储藏

应用储藏

清理工作目录

检查修改、撤销操作

检查修改

撤销操作

已修改，未暂存

已暂存，未提交

已提交，未推送

已推送

git reset 命令