Git 使用 git add –patch 交互式地添加部分 hunk

在本文中，我们将介绍如何使用 git add --patch 命令来交互式地添加部分 hunk。Git 是一个分布式版本控制系统，它允许我们跟踪文件的修改并进行版本控制。git add 命令用于将文件的修改添加到暂存区，而 --patch 选项则允许我们按照 hunk 的粒度选择部分修改进行添加。

阅读更多：Git 教程

什么是 hunk？

在 Git 中，hunk 指的是文件中的一块连续的修改。它可以是一段代码的修改、一行或多行的修改，或者是文件的一部分修改。使用 git diff 命令可以查看文件的修改，并且这些修改会以 hunk 的形式显示出来。当我们对文件进行修改后，可以使用 git add --patch 命令选择性地添加这些 hunk 到暂存区，以便将这些修改包含在下一次的提交中。

如何使用 git add –patch？

使用 git add --patch 命令的格式如下：

git add --patch <file>

其中 <file> 是要添加的文件。下面是一些常用的交互式添加的命令：

y：将 hunk 添加到暂存区。
n：不将 hunk 添加到暂存区。
a：将当前以及之后的所有 hunk 添加到暂存区。
q：退出交互式模式。

这些命令将会在执行 git add --patch 后的命令行界面中显示出来，我们可以根据需要选择相应的命令来添加或忽略部分 hunk。

一个例子

假设我们有一个名为 example.py 的文件，其内容如下：

def add(a, b):
    # add two numbers
    return a + b

def subtract(a, b):
    # subtract two numbers
    return a - b

def multiply(a, b):
    # multiply two numbers
    return a * b

def divide(a, b):
    # divide two numbers
    return a / b

result = add(3, 5)
print(result)

我们对该文件进行了三处修改：

修改了 add 函数的注释。
增加了一个新的函数 modulus。
修改了 example.py 文件的最后一行。

我们可以使用 git diff 命令来查看这些修改，然后使用 git add --patch 来交互式地添加部分 hunk。

首先，我们执行 git diff example.py 命令来查看文件的修改：

diff --git a/example.py b/example.py
index 1234567..abcdefg 100644
--- a/example.py
+++ b/example.py
@@ -1,11 +1,11 @@
 def add(a, b):
-    # add two numbers
+    # add two integers
     return a + b

 def subtract(a, b):
-    # subtract two numbers
+    # subtract two integers
     return a - b

 def multiply(a, b):
-    # multiply two numbers
+    # multiply two integers
     return a * b

 def divide(a, b):
@@ -13,3 +13,7 @@ def divide(a, b):
     return a / b

 result = add(3, 5)
-print(result)
\ No newline at end of file
+print(result)
+
+def modulus(a, b):
+    # compute modulus
+    return a % b
\ No newline at end of file

接下来，我们执行 git add --patch example.py 命令来交互式地添加部分 hunk：

Stage this hunk [y,n,q,a,d,/,j,J,g,e,?]? y

这里只有一个 hunk 被显示出来，我们选择将其添加到暂存区（输入 y），然后继续执行命令：

Stage this hunk [y,n,q,a,d,/,j,J,g,e,?]? /

这次有一个新的 hunk 被显示出来，我们使用 / 命令查看所有的 hunk，然后选择了第二个 hunk 添加到暂存区：

Stage this hunk [y,n,q,a,d,/,j,J,g,e,?]? 2

最后，我们可以使用 git diff --cached 命令来查看已经添加到暂存区的 hunk：

diff --git a/example.py b/example.py
index 1234567..abcdefg 100644
--- a/example.py
+++ b/example.py
@@ -1,11 +1,11 @@
 def add(a, b):
-    # add two numbers
+    # add two integers
     return a + b

 def subtract(a, b):
-    # subtract two numbers
+    # subtract two integers
     return a - b

 def multiply(a, b):
-    # multiply two numbers
+    # multiply two integers
     return a * b

 def divide(a, b):
@@ -13,3 +13,7 @@ def divide(a, b):
     return a / b

 result = add(3, 5)
-print(result)
\ No newline at end of file
+print(result)

+def modulus(a, b):
+    # compute modulus
+    return a % b
\ No newline at end of file

现在，已经成功将我们选择的 hunk 添加到了暂存区。

总结

通过使用 git add --patch 命令，我们可以交互式地添加部分 hunk 到暂存区。这对于我们需要选择性地添加文件的修改非常有帮助。通过演示一个例子，我们展示了如何使用该命令来交互式地添加 hunk，并结合其他 Git 命令来完成版本控制的工作。希望本文对你理解 git add –patch 命令有所帮助。