• Git最重要的应用场景是多人协同开发，但如何保证每个人之间的开发不影响他人的开发过程，Git 分支的出现是为了解决这个问题，使每个人之间的发展独立，不相互影响。
• 与许多其他版本的控制系统不同，Git 鼓励分支和合并在工作过程中频繁使用，即使一天内多次。

【创建分支】 Git创建分支非常简单，我们可以使用它git branch查看现有分支或创建新分支。输入无任何命令参数时git branch它可以帮助我们检查当前项目的所有分支。Git会使用*标明我们目前的分支。

git branch 

结果为：

* master 

当我们想增加新的分支时，我们只需要git branch命令后面加上我们想要新建的分支的名称即可。

# 创建issue102的分支 git branch issue102 # 检查所有现有分支 git branch 

# 现有的分支 issue102 *master 

我们可以发现，虽然创建了issue102但目前的分支还在master上。我们可以通过git checkout命令切换分支。

分支切换 在上面的例子中我们发现虽然创建了新的分支，但是当前分支还是在master我们需要通过分支git checkout命令切换到新建的issue102分支，进行后续开发操作。

git checkout issue102 

Switched to branch 'issue102' 

这是我们可以检查当前分支的状态，我们可以发现当前分支已经转换为issue102分支上。

git branch * issue102 master 

切换分支后，我们可以自己开发。分支上的文件状态不同。通过以下例子，我们可以有更深入的了解。

# 切换分支 git checkout issue102  # 在分支上创建新的文件 touch issue102.md git add issue102.md git commit -m "update issue102.md"  touch issue102.html git add issue102.html git commit -m update issue102.html"

实际操作如下： 在完成上述命令后，我们可以通过git log --oneline检查下当前Git的记录。

cd836b0 (HEAD -> issue102) update issue102.html
7575f02 update issue102.md
242c407 (master) update hello.md

我们可以发现issue102分支上的记录与master的记录间隔开了。除此之外，当我们切换回主分支后，我们还会发现master分支下没有新建的issue102.md和issue102.html两个文件。正如下图所示：

当我们在分支上完成来开发工作后，我们需要将我们在当前分支进行的工作合并到主分支上。首先我们需要切回需要合并到的分支上，此处以issue102合并到master上为例子进行演示。

# 切换回主分支
git checkout master
# 使用git merge 进行合并
git merge issue102
# git branch --no-merged
# 查看所有未合并工作的分支

我们可以发现原来在issue102分支上的文件已经合并到了主分支上了，并且issue102分支还存在。大家可以根据实际的需求进行分支的保留与删除。

有时候分支的合并不会一番顺利，当我们在两个分支中对同一个文件的同一个部分进行了不同的修改，Git就没有办法顺利的合并他们，会在合并的时候产生合并冲突。比如我们在issue102分支和master分支下对issue102.md文件进行了修改，当我们将issue102分支融合到主分支上时就会发生冲突。如下图所示：

我们也可以通过git status查看命令来查看那些因包含合并冲突而处于未合并（unmerged）状态的文件。当出现矛盾后，合并的文件内容将会出现"<<<<<<“,”=======“,”>>>>>>"等分割线来进行标记。如下图所示：

当出现了矛盾时，我们需要进行手动解决或者放弃合并。

• 手动合并

  手动合并的方法很简单，就是我们选择我们要保留的代码，然后再把>>>>>, ======, <<<<<<这些提示行给去掉。最后重新进行add commit的操作即可。

• 放弃合并

  当我们发现冲突所导致的改动量很大时，我们可以选择放弃该次的合并。我们可以使用git merge --abort放弃此次的融合。如果我们在运行了git merge之后又进行了一些人为的改动，那么在abort之后，所进行的改动也会被回滚掉。

• mergetool

  除了手动合并以及放弃合并之外，我们还有一些其他的合并工具。git官方开发了一个专门用来合并的工具，叫做git mergetool(下图所示)，它会将找到一份两个分支的祖先代码作为base（基准），然后再将两个分支的改动都列举出来作为对比，让我们在git编辑器当中决定要留下什么。在此处，我们不做过多的阐述，感兴趣的同学可以点击下方链接进行查看。

  1. Use vimdiff as git mergetool
  2. 使用vimdiff作为git mergetool
  3. git-mergetool

在很多情况下，我们都需要将分支推送到远程，在这一部分，我们将讲一些远程的相关操作。 首先，我们可以使用git remote -v查看远程库的详细信息。会显示我们可以抓取或推送的origin地址。

$ git remote -v
origin  git@github.com:ProjectOwner/ProjectName.git (fetch)
origin  git@github.com:ProjectOwner/ProjectName.git (push)

当我们需要推送本地分支到远程时，需要指定具体的本地分支。

# 推送本地的master分支到远程
git push origin master
# 推送本地的issue102分支到远程
git push origin issue102

但是当我们多人协作进行开发的时候，可能会出现远程分支比我们本地更新的情况，这时，我们就需要使用git pull的命令来试图合并。如果合并出现冲突时，我们需要解决冲突再提交。

更多参考：廖雪峰老师的Git教程中的多人协作。

在Git中没有什么分支是不可以删除的（除了当前所在的分支不能删除），包括master分支也是可以进行删除。 Git的分支删除可以分为删除本地分支和远程分支。

• 删除本地分支

# branchName 是需要删除的本地分支名字
git branch -d branchName

当我们想强行删除分支时，只需要将参数d改为D即可。

• 删除远程分支

# origin 是远程的主机名
# branch 需要删除的远程分支
git push origin --delete branch

当我们需要重命名分支的名称时，我们可以使用git branch命令来进行，具体方式如下：

# oldBranchName: 旧分支名
# newBranchName ：新分支名
git branch -m oldBranchName newBranchName

当我们想要将改名后的分支推送到远程时，我们需要进行如下操作：

git branch -m oldBranchName newBranchName   # 将本地的分支进行重命名
git push origin newBranchName               # 将新的分支推送到远程 
git push --delete origin oldBranchName      # 删除远程的旧的分支 

常见的分支开发工作流程： 由于分支管理的便捷，才衍生出这些典型的工作模式，可以根据项目实际情况进行使用。

• 在整个项目开发周期的不同阶段，我们可以同时拥有多个分支；然后我们可以定期地把某些主题分支合并入其他分支中。比如只在 master 分支上保留完全稳定的代码——有可能仅仅是已经发布或即将发布的代码。
• 他们还有一些名为 develop 或者 next 的平行分支，被用来做后续开发或者测试稳定性——这些分支不必保持绝对稳定，但是一旦达到稳定状态，它们就可以被合并入 master 分支了。
• 在确保这些已完成的主题分支（短期分支，比如之前的 issue102 分支）能够通过所有测试，并且不会引入更多 bug 之后，就可以合并入主干分支中，等待下一次的发布。

• 短期分支也可以叫做主题分支，它的作用是用来实现某一种特性或者相关工作（修复bug，开发产品新特性）。
• 比如当我们的产品出现了bug时，我们应该新建一个分支并起名为bug分支，并在该分支上进行bug的修复，等我们的代码确定不会引起其他bug时，我们就可以合并到主分支上进行修复。
• 当我们看见issue时，我们也可以使用同样的方式来解决issue的问题。常见的短期分支还有上面提到的develop，topic分支。

在实际开发中，我们应该按照以下几个基本原则进行分支开发工作流程

1. master分支应该是最稳定的，也就是仅用来发布新版本，平时不能直接在上面进行操作，应该保存在远程。
2. 短期分支是我们干活的分支，短期分支可以不用上传到远程，当我们完成了bug的修复，新功能的开发时才需要合并到主分支上。
3. 多使用分支来进行开发工作。

本章主要介绍 Git 常用的工具，可能不会经常用到

需要一些简单的文件和目录来演示该章节，如果可以的话，请 fork 这个演示项目至你的个人账号下。

https://github.com/datawhalechina-git-samples/app

后续演示均以这个 repo 操作。

Git 支持多种方式来引用单个提交、一组提交或一定范围内的提交。

你可以通过任意一个提交的 40 位字符的 SHA-1散列值来指定它。

$ 是终端交互的提示符，不需要输入。如果系统或者终端不一样，只需输入$后的内容即可，本文后续不再累述

切换至本项目工作目录，执行 git log 能看到类似提交日志的输出。(shell 通过 pipe | 将输出信息传递给 more 做多页显示)。

$ git log | more

commit 44328544187650f2f6ecc253ef3a2b099c51baa5
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 13:41:55 2022 +0800

    add model module

commit a55ea122894272b13c3a43129ca0b74cfd2b6a4a
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 13:33:17 2022 +0800

    Initial commit

从日志能明显的看到多次提交的记录，每次包括 commit + 一串字符、作者、提交时间 和详细信息等。

这里的主角就是 commit 后跟的 40 位的字符，这个值是一个 SHA-1 哈希值。它是对内容和头信息 Header 的一个校验和 checksum，Git 使用 SHA-1 并不是为了数据的安全性，而是数据的完整性；它保证，在很多年后，你重新 checkout 某个 commit 时，一定是当时的状态，完全一摸一样。 有兴趣进一步了解这个 SHA-1 的值，可以 参考这里。

想查看某次提交信息，可以通过 git show 来查看，如:

$ git show 44328544187650f2f6ecc253ef3a2b099c51baa5

commit 44328544187650f2f6ecc253ef3a2b099c51baa5 (HEAD -> main, origin/main, origin/HEAD)
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 13:41:55 2022 +0800

    add model module

diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..f9d131a
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "model"]
+       path = model
+       url = https://github.com/datawhalechina-git-samples/model
diff --git a/model b/model
new file mode 160000
index 0000000..a8328fd
--- /dev/null
+++ b/model
@@ -0,0 +1 @@
+Subproject commit a8328fd6ee683ef8f6a2d7c4edfefed2923b0795

查看所有所有提交 SHA-1 字符串

$ git log|grep '^commit'|awk '{print $2}'

44328544187650f2f6ecc253ef3a2b099c51baa5
a55ea122894272b13c3a43129ca0b74cfd2b6a4a

Git 非常聪明的知道在没有歧义的情况下，通过前几个字符来替代上述 40 位字符，如上可简化成：

 $ git show 4432854

甚至简化成

$ git show 4432

当然你的确保没有歧义。Git 可以为 SHA-1 值生成出简短且唯一的缩写，可以在 git log 后加 --abbrev-commit 参数，输出结果就会显示简短且唯一的值了。默认情况使用 7 个字符，有时为来避免歧义，会增加字符数。

$ git log --abbrev-commit

commit 4432854 (HEAD -> main, origin/main, origin/HEAD)
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 13:41:55 2022 +0800

    add model module

commit a55ea12
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 13:33:17 2022 +0800

    Initial commit

通过在 git log后增加 --pretty=oneline简化输出内容

$ git log --abbrev-commit --pretty=oneline

4432854 (HEAD -> main, origin/main, origin/HEAD) add model module
a55ea12 Initial commit

如果你要查看一个分支的最后一次对象，可以通过分支名查看。查看本地分支列表通过git branch查看

$ git branch

  develop
  main
* stable

* 表示当前工作的分支

查看远程分支通过后加参数-r

$ git branch -r

  origin/HEAD -> origin/main
  origin/main
  origin/stable

我们尝试通过git show stable查看指定分支最后一次提交信息

$ git show stable

commit 11671bae8489621c02a4c99dbcf24b0dede1b1b1 (HEAD -> stable)
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 14:16:00 2022 +0800

    stable model for app

diff --git a/.gitmodules b/.gitmodules
index f9d131a..47d8924 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,3 +1,4 @@
 [submodule "model"]
        path = model
        url = https://github.com/datawhalechina-git-samples/model
+       branch = stable
diff --git a/model b/model
index a8328fd..ca79fae 160000
--- a/model
+++ b/model
@@ -1 +1 @@
-Subproject commit a8328fd6ee683ef8f6a2d7c4edfefed2923b0795
+Subproject commit ca79fae869c9b4ddd7999f06ffd48ac25971b9dd

如果你的 branch 的名称和当前目录名称很不巧的重名了，那么应该会出现意外的输出 😭 并没有我们期盼中的结果。

创建同名测试目录

$ mkdir stable

再次执行git show stable

$ git show stable

fatal: ambiguous argument 'stable': both revision and filename
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

Git 不知道如何处理，我们需要通过 -- 明确告知.

• – 前面的为 revision 可以是分支，tag 等
• – 后面的为 file 即要操作的文件

$ git show stable --

我们通过 git rev-parse可以查看某个分支指向那个特定的 SHA-1, 并通过 git show 去查看这个 SHA-1 值对应的提交信息。

$ git rev-parse stable

11671bae8489621c02a4c99dbcf24b0dede1b1b1

$ git show 11671bae8489621c02a4c99dbcf24b0dede1b1b1

我们能看到是一致的信息。

当你在工作时， Git 会在后台保存一个引用日志（reflog）， 引用日志记录了最近几个月你的 HEAD 和分支引用所指向的历史。 你可以使用 git reflog 来查看引用日志

$ git reflog

11671ba (HEAD -> stable, origin/stable) HEAD@{ 
        0}: commit: stable model for app
4432854 (origin/main, origin/HEAD, main, develop) HEAD@{ 
        1}: checkout: moving from main to stable
4432854 (origin/main, origin/HEAD, main, develop) HEAD@{ 
        2}: commit: add model module
a55ea12 HEAD@{ 
        3}: clone: from https://github.com/datawhalechina-git-samples/app

每当你的 HEAD 所指向的位置发生了变化，Git 就会将这个信息存储到引用日志这个历史记录里。 你也可以通过 reflog 数据来获取之前的提交历史。 如果你想查看仓库中 HEAD 在 2 次前的所指向的提交，你可以使用 @{n} 来引用 reflog 中输出的提交记录。

$ git show HEAD@{ 
        2}

commit 44328544187650f2f6ecc253ef3a2b099c51baa5 (origin/main, origin/HEAD, main, develop)
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 13:41:55 2022 +0800

    add model module

diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..f9d131a
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "model"]
+       path = model
+       url = https://github.com/datawhalechina-git-samples/model
diff --git a/model b/model
new file mode 160000
index 0000000..a8328fd
--- /dev/nullq
+++ b/model
@@ -0,0 +1 @@
+Subproject commit a8328fd6ee683ef8f6a2d7c4edfefed2923b0795

当你修改大量文件后，希望将改动拆分成多个提交而不是一起提交的时候，可以通过如下命令操作。

如果运行 git add 后加 -i 或者 --interactive 选项的时候，Git 会进入一个交互式命令模式，如:

$ git add -i

           staged     unstaged path
  1:      +532/-0      nothing src/trace/events.go
  2:      +365/-0      nothing src/trace/histogram.go
  3:      +325/-0      nothing src/trace/histogram_test.go
  4:     +1130/-0      nothing src/trace/trace.go
  5:      +178/-0      nothing src/trace/trace_test.go

*** Commands ***
  1: status	  2: update	  3: revert	  4: add untracked
  5: patch	  6: diff	  7: quit	  8: help
What now>

可以看到这个命令以和平时不同的视图：显示了暂存区。基本上与 git status 是相同的信息，但是更简明扼要一些。 它将暂存的修改列在左侧，未暂存的修改列在右侧。

在这块区域后是 Commands 命令区域。 在这里你可以做一些工作，包括暂存文件、取消暂存文件、暂存文件的一部分、添加未被追踪的文件、显示暂存内容的区别。

在 Waht now>> 提示符后输入u或者2，它会提示你要暂存哪个文件

$ git add -i

           staged     unstaged path
  1:      +532/-0      nothing src/trace/events.go
  2:      +365/-0      nothing src/trace/histogram.go
  3:      +325/-0      nothing src/trace/histogram_test.go
  4:     +1130/-0      nothing src/trace/trace.go
  5:      +178/-0        +1/-1 src/trace/trace_test.go

*** Commands ***
  1: status	  2: update	  3: revert	  4: add untracked
  5: patch	  6: diff	  7: quit	  8: help

What now> u
           staged     unstaged path
  1:      +178/-0        +1/-1 src/trace/trace_test.go
Update>> 1
           staged     unstaged path
* 1:      +178/-0        +1/-1 src/trace/trace_test.go
Update>>
updated 1 path

*** Commands ***
  1: status	  2: update	  3: revert	  4: add untracked
  5: patch	  6: diff	  7: quit	  8: help
What now> s
           staged     unstaged path
  1:      +532/-0      nothing src/trace/events.go
  2:      +365/-0      nothing src/trace/histogram.go
  3:      +325/-0      nothing src/trace/histogram_test.go
  4:     +1130/-0      nothing src/trace/trace.go
  5:      +178/-0      nothing src/trace/trace_test.go

再输入u 后根据提示的文件列表，输入序号，这里我们要暂存src/trace/trace_test.go，输入 5, 会看到文件名称有个*，意味着选中的文件将被暂存。如果不需要其他操作了，直接按回车，不输入任何东西返回命令行界面。通过命令s查看状态，发现src/trace/trace_test.go 已经被暂存了。

如果想取消暂存，在 Waht now>> 提示符后输入r或者3，进行撤销，同上的操作。

如果想要查看已暂存内容的区别，可以使用 d 或 6（区别）命令。 它会显示暂存文件的一个列表，可以从中选择想要查看的暂存区别。 这跟你在命令行指定 git diff --cached 非常相似：

$ git add -i

           staged     unstaged path
  1:        +1/-1      nothing src/trace/trace_test.go

What now> d
           staged     unstaged path
  1:        +1/-1      nothing src/trace/trace_test.go

Review diff>> 1

diff --git a/src/trace/trace_test.go b/src/trace/trace_test.go
index 8cc7998..33732e6 100644
--- a/src/trace/trace_test.go
+++ b/src/trace/trace_test.go
@@ -1,7 +1,7 @@
 // Copyright 2015 The Go Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
-
+//
 package trace

 import (

通过这些基本命令，可以使用交互式添加模式来轻松地处理暂存区。

Git 也可以暂存文件的特定部分。 例如，如果在 TODO 文件中做了两处修改，但只想要暂存其中的一个而不是另一个，Git 会帮你轻松地完成。 在和上一节一样的交互式提示符中，输入 p 或 5。

$ git add -i

           staged     unstaged path
  1:    unchanged        +2/-1 src/trace/trace_test.go

*** Commands ***
  1: status	  2: update	  3: revert	  4: add untracked
  5: patch	  6: diff	  7: quit	  8: help
What now> p
           staged     unstaged path
  1:    unchanged        +2/-1 src/trace/trace_test.go

Patch update>> 1
           staged     unstaged path
* 1:    unchanged        +2/-1 src/trace/trace_test.go
Patch update>>

diff --git a/src/trace/trace_test.go b/src/trace/trace_test.go
index 8cc7998..a95f46e 100644
--- a/src/trace/trace_test.go
+++ b/src/trace/trace_test.go
@@ -1,7 +1,8 @@
 // Copyright 2015 The Go Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style
 // license that can be found in the LICENSE file.
-
+//
+// copy from go framework
 package trace

 import (
(1/1) Stage this hunk [y,n,q,a,d,e,?]?

输入p 后，选择你需要操作的文件后，直接敲回车，会逐一询问你是否需要暂存他们，(1/1) 表示当前是第 1 个初变更，共 1 处变更。选项很多，输入?可以查看具体的解释

y - stage this hunk
n - do not stage this hunk
q - quit; do not stage this hunk or any of the remaining ones
a - stage this hunk and all later hunks in the file
d - do not stage this hunk or any of the later hunks in the file
g - select a hunk to go to
/ - search for a hunk matching the given regex
j - leave this hunk undecided, see next undecided hunk
J - leave this hunk undecided, see next hunk
e - manually edit the current hunk
? - print help

通过y或者n来选择是否要暂存每一区块，当然也可以通过a暂存从这到后面所有当前文件的修改。暂存成功后，退出交互命令，我们就可以通过git commit来提交这部分暂存的文件了。

很多时候，你在当前分支上工作了一段时间后，东西变得很混乱。你想切换至新的分支而又不想放弃放弃的修改，或者纯粹想先做其他分支的事情的时候，就该git stash上场了。

stash 会处理工作目录的的状态，跟踪文件的修改和暂存的改动，然后将未完成的修改保存至一个栈上，这样就可以在后续任何时间切换回来。

$ git status

On branch main
Your branch is up to date with 'origin/main'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   src/trace/trace_test.go

no changes added to commit (use "git add" and/or "git commit -a")

文件被修改了一大坨，但是还没修改完，暂时还不想提交，而我又想切换至新的分支，这时候就需要stash，先把变更推送至栈上，运行git stash 或者 git stash push

$ git stash

Saved working directory and index state WIP on main: a123887 sample codes for demonstration

然后再查看git status

$ git status

On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

我们能看到当前目录已经非常干净了，这时候你可以按常规操作一样，做你想做的其他的事情。如切换新的分支，或者我想不到的事情.

那么要返回刚才那坨文件该怎么办呢？通过 git stash list 查看所有 stash 的列表

$ git stash list

stash@{ 
        0}: WIP on main: 36c4cad sample codes for demonstration

切换至最后 stash 变更，直接执行 git stash apply 即可，当然如果有多个，可以通过 git stash apply stash@{n} 中的 n 来获取指定的的变更。

$ git stash apply

On branch main
Your branch is up to date with 'origin/main'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   src/trace/trace_test.go

no changes added to commit (use "git add" and/or "git commit -a")

git stash apply stash@{0} 会输出同样的内容。

可以通过 git stash drop 或者 git stash pop 来删除 stash 的内容。

$ git stash drop stash@{ 
        0}

Dropped stash@{ 
        0} (36c4cad0bafa4dbbd78ae469b0afa38ae2808102)

对于一些不需要的文件或目录，你需要的是清理它而不是保存修改记录，git clean就是用来做这个事情的

需要注意的是，这个命令会移除未被跟踪的文件，可以考虑执行 git stash --all 来移除所有文件并保存到栈上。

使用 git clean -f -d 命令来移除工作目录中所有未追踪的文件以及空的子目录。 -f 意味着强制移除，使用它需要 Git 配置变量 clean.requireForce 没有显式设置为 false。

如果你只是想看下或者删除前小心翼翼的确认: 它到底会删除那些东西. 可以通过--dry-run或者-n选项来执行命令，这只是告诉你会删除什么，而不会真的删除.

创建一些临时文件用于测试

$ touch temp; mkdir log; mkdir target; touch target/main

通过git clean -n查看

$ git clean -n

Would remove temp

默认情况下，git clean 命令只会移除没有忽略的未跟踪文件。 任何与 .gitignore 或其他忽略文件中的模式匹配的文件都不会被移除。如果你也想移除，可以通过增加选项-x

$ git clean -n -x

Would remove .DS_Store
Would remove temp

同样增加选项-d可以删除目录

$ git clean -n -x -d

Would remove .DS_Store
Would remove log/
Would remove target/
Would remove temp

如果你想交互删除，可以通过选项 -i来操作

Would remove the following items:
  .DS_Store  log/       target/    temp

*** Commands ***
    1: clean                2: filter by pattern    3: select by numbers    4: ask each             5: quit
    6: help
What now>

通过What now后输入命令或序号交互操作，不知道可以输入 help 查看具体的描述

What now> help

clean               - start cleaning
filter by pattern   - exclude items from deletion
select by numbers   - select items to be deleted by numbers
ask each            - confirm each deletion (like "rm -i")
quit                - stop cleaning
help                - this screen
?                   - help for prompt selection

无论仓库里的代码量有多少，你经常需要查找一个函数是在哪里调用或者定义的，或者显示一个方法的变更历史。 Git 提供了两个有用的工具来快速地从它的数据库中浏览代码和提交。 我们来简单的看一下。

Git 提供了一个grep命令，可以很方便的从提交历史，工作目录，甚至索引中查找一个字符串或者正则表达式。

默认情况下git grep会查找你的工作目录文件。

$ git grep a.percentileBoundary

src/trace/histogram.go:func (h *histogram) percentileBoundary(percentile float64) int64 { 
        
src/trace/histogram.go: return h.percentileBoundary(0.5)
src/trace/histogram_test.go:            percentile := a.percentileBoundary(test.fraction)

通过-n或者--line-number显示匹配的行号

$ git grep -n percentileBoundary

src/trace/histogram.go:120:func (h *histogram) percentileBoundary(percentile float64) int64 { 
        
src/trace/histogram.go:166:     return h.percentileBoundary(0.5)
src/trace/histogram_test.go:181:                percentile := a.percentileBoundary(test.fraction)

通过-c或者--count输出统计信息

git grep -c percentileBoundary

src/trace/histogram.go:2
src/trace/histogram_test.go:1

通过-p 或者 --show-function 显示每个匹配字符串所在的方法或函数

 git grep -p percentileBoundary

src/trace/histogram.go=func (h *histogram) standardDeviation() float64 { 
        
src/trace/histogram.go:func (h *histogram) percentileBoundary(percentile float64) int64 { 
        
src/trace/histogram.go=func (h *histogram) median() int64 { 
        
src/trace/histogram.go: return h.percentileBoundary(0.5)
src/trace/histogram_test.go=func TestPercentileBoundary(t *testing.T) { 
        
src/trace/histogram_test.go:            percentile := a.percentileBoundary(test.fraction)

通过git log可以很强大的知道一些特定的提交信息。

如通过-S选项知道内容的新增和删除提交记录，我们这里以 CTP 的 Python 的 wrapper 为例:

$ git log -S percentileBoundary

a123887 (HEAD -> main, origin/main, origin/HEAD) sample codes for demonstration

通过-L选项进行行日志搜索，它可以展示代码中一行或者一个函数的历史。

$ git log -L :percentileBoundary:src/trace/histogram.go

commit a123887e43424c979b3e47b3cf9c672c579a6faa (HEAD -> main, origin/main, origin/HEAD)
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 14:34:18 2022 +0800

    sample codes for demonstration

diff --git a/src/trace/histogram.go b/src/trace/histogram.go
--- /dev/null
+++ b/src/trace/histogram.go
@@ -0,0 +120,45 @@
+func (h *histogram) percentileBoundary(percentile float64) int64 { 
        
+       total := h.total()
+
+       // Corner cases (make sure result is strictly less than Total())
+       if total == 0 { 
        
+               return 0
+       } else if total == 1 { 
        
+               return int64(h.average())
+       }
...

如果 Git 无法匹配到你的函数或者方法，可以通过正则表达式，如这个命令和上面是等效的

$ git log -L '/percentileBoundary/',/^}/:src/trace/histogram.go

commit a123887e43424c979b3e47b3cf9c672c579a6faa (HEAD -> main, origin/main, origin/HEAD)
Author: Martin Xu <martin.xus@gmail.com>
Date:   Wed May 4 14:34:18 2022 +0800

    sample codes for demonstration

diff --git a/src/trace/histogram.go b/src/trace/histogram.go
--- /dev/null
+++ b/src/trace/histogram.go
@@ -0,0 +120,43 @@
+func (h *histogram) percentileBoundary(percentile float64) int64 { 
        
+       total := h.total()
+
+       // Corner cases (make sure result is strictly less than Total())
+       if total == 0 { 
        
+               return 0
...

项目中经常会遇到包含另外一个项目，如：第三方库，或者你将自己的项目切分成多个子项目，然后在其他项目中引用，如，将项目中的 model 独立处理，独立维护；其他项目组引用这个项目，并不维护 model。这里我们可以将 model 做子项目添加到当前项目中。

通过 git submodule add 添加子模块, 大家可以使用 https://github.com/datawhalechina-git-samples/model 进行测试，如

$ git submodule add https://github.com/datawhalechina-git-samples/model

Cloning into '/Users/martin/project/datawhalechina/app/model'...

remote: Enumerating objects: 5, done.
remote: Counting objects: 100% (5/5), done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 5 (delta 0), reused 0 (delta 0), pack-reused 0
Receiving objects: 100% (5/5), done.

参数同 clone，默认是 repo 的名称，如果你想改名，可以在后续增加新的名称或路径。

通过 git status 能看到新的 model 库。

$ git status

On branch main
Your branch is up to date with 'origin/main'.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	new file:   .gitmodules
	new file:   model

能看到有个新增的 model 和 .gitmodules文件，该配置文件保存了项目 URL 和本地目录的 mapping 关系。

$ cat .gitmodules

[submodule "model"]
	path = model
	url = https://github.com/datawhalechina-git-samples/model

如果有多个子模块，这里会列出多条。

通过git diff能看到更详细的信息

$ git diff --cached model

diff --git a/model b/model
new file mode 160000
index 0000000..a8328fd
--- /dev/null
+++ b/model