7.2 Git 工具 - 交互式暂存

交互式暂存

本节中的几个交互式 Git 命令可以帮助你将文件的特定部分组合成提交。 当你在修改了大量文件后，希望这些改动能拆分为若干提交而不是混杂在一起成为一个提交时，这几个工具会非常有用。 通过这种方式，可以确保提交是逻辑上独立的变更集，同时也会使其他开发者在与你工作时很容易地审核。 如果运行 git add 时使用 -i 或者 --interactive 选项，Git 将会进入一个交互式终端模式，显示类似下面的东西：

  1. $ git add -i
  2.            staged     unstaged path
  3.   1:    unchanged        +0/-1 TODO
  4.   2:    unchanged        +1/-1 index.html
  5.   3:    unchanged        +5/-1 lib/simplegit.rb
  7. *** Commands ***
  8.   1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  9.   5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
  10. What now>

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

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

暂存与取消暂存文件

如果在 What now> 提示符后键入 u 或 2（更新），它会问你想要暂存哪个文件：

  1. What now> u
  2.            staged     unstaged path
  3.   1:    unchanged        +0/-1 TODO
  4.   2:    unchanged        +1/-1 index.html
  5.   3:    unchanged        +5/-1 lib/simplegit.rb
  6. Update>>

要暂存 TODO 和 index.html 文件，可以输入数字：

  1. Update>> 1,2
  2.            staged     unstaged path
  3. * 1:    unchanged        +0/-1 TODO
  4. * 2:    unchanged        +1/-1 index.html
  5.   3:    unchanged        +5/-1 lib/simplegit.rb
  6. Update>>

每个文件前面的 * 意味着选中的文件将会被暂存。 如果在 Update>> 提示符后不输入任何东西并直接按回车，Git 将会暂存之前选择的文件：

  1. Update>>
  2. updated 2 paths
  4. *** Commands ***
  5.   1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  6.   5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
  7. What now> s
  8.            staged     unstaged path
  9.   1:        +0/-1      nothing TODO
  10.   2:        +1/-1      nothing index.html
  11.   3:    unchanged        +5/-1 lib/simplegit.rb

现在可以看到 TODO 与 index.html 文件已经被暂存而 simplegit.rb 文件还未被暂存。 如果这时想要取消暂存 TODO 文件，使用 r 或 3（撤消）选项：

  1. *** Commands ***
  2.   1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  3.   5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
  4. What now> r
  5.            staged     unstaged path
  6.   1:        +0/-1      nothing TODO
  7.   2:        +1/-1      nothing index.html
  8.   3:    unchanged        +5/-1 lib/simplegit.rb
  9. Revert>> 1
  10.            staged     unstaged path
  11. * 1:        +0/-1      nothing TODO
  12.   2:        +1/-1      nothing index.html
  13.   3:    unchanged        +5/-1 lib/simplegit.rb
  14. Revert>> [enter]
  15. reverted one path

再次查看 Git 状态，可以看到已经取消暂存 TODO 文件：

  1. *** Commands ***
  2.   1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  3.   5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
  4. What now> s
  5.            staged     unstaged path
  6.   1:    unchanged        +0/-1 TODO
  7.   2:        +1/-1      nothing index.html
  8.   3:    unchanged        +5/-1 lib/simplegit.rb

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

  1. *** Commands ***
  2.   1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  3.   5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
  4. What now> d
  5.            staged     unstaged path
  6.   1:        +1/-1      nothing index.html
  7. Review diff>> 1
  8. diff --git a/index.html b/index.html
  9. index 4d07108..4335f49 100644
  10. --- a/index.html
  11. +++ b/index.html
  12. @@ -16,7 +16,7 @@ Date Finder
  14.  <p id="out">...</p>
  16. -<div id="footer">contact : support@github.com</div>
  17. +<div id="footer">contact : email.support@github.com</div>
  19.  <script type="text/javascript">

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

暂存补丁

Git 也可以暂存文件的特定部分。 例如，如果在 simplegit.rb 文件中做了两处修改，但只想要暂存其中的一个而不是另一个，Git 会帮你轻松地完成。 在和上一节一样的交互式提示符中，输入 p 或 5（补丁）。 Git 会询问你想要部分暂存哪些文件；然后，对已选择文件的每一个部分，它都会一个个地显示文件区别并询问你是否想要暂存它们：

  1. diff --git a/lib/simplegit.rb b/lib/simplegit.rb
  2. index dd5ecc4..57399e0 100644
  3. --- a/lib/simplegit.rb
  4. +++ b/lib/simplegit.rb
  5. @@ -22,7 +22,7 @@ class SimpleGit
  6.    end
  8.    def log(treeish = 'master')
  9. -    command("git log -n 25 #{treeish}")
  10. +    command("git log -n 30 #{treeish}")
  11.    end
  13.    def blame(path)
  14. Stage this hunk [y,n,a,d,/,j,J,g,e,?]?

这时有很多选项。 输入 ? 显示所有可以使用的命令列表：

  1. Stage this hunk [y,n,a,d,/,j,J,g,e,?]? ?
  2. y - stage this hunk
  3. n - do not stage this hunk
  4. a - stage this and all the remaining hunks in the file
  5. d - do not stage this hunk nor any of the remaining hunks in the file
  6. g - select a hunk to go to
  7. / - search for a hunk matching the given regex
  8. j - leave this hunk undecided, see next undecided hunk
  9. J - leave this hunk undecided, see next hunk
  10. k - leave this hunk undecided, see previous undecided hunk
  11. K - leave this hunk undecided, see previous hunk
  12. s - split the current hunk into smaller hunks
  13. e - manually edit the current hunk
  14. ? - print help

通常情况下可以输入 y 或 n 来选择是否要暂存每一个区块， 当然，暂存特定文件中的所有部分或为之后的选择跳过一个区块也是非常有用的。 如果你只暂存文件的一部分，状态输出可能会像下面这样：

  1. What now> 1
  2.            staged     unstaged path
  3.   1:    unchanged        +0/-1 TODO
  4.   2:        +1/-1      nothing index.html
  5.   3:        +1/-1        +4/-0 lib/simplegit.rb

simplegit.rb 文件的状态很有趣。 它显示出若干行被暂存与若干行未被暂存。 已经部分地暂存了这个文件。 在这时，可以退出交互式添加脚本并且运行 git commit 来提交部分暂存的文件。

也可以不必在交互式添加模式中做部分文件暂存——可以在命令行中使用 git add -p 或 git add --patch 来启动同样的脚本。

更进一步地，可以使用 git reset --patch 命令的补丁模式来部分重置文件， 通过 git checkout --patch 命令来部分检出文件与 git stash save --patch 命令来部分暂存文件。 我们将会在接触这些命令的高级使用方法时了解更多详细信息。