[git] 如何合并最近的若干个 commit？（上）

背景

当我们在一个特性分支进行开发时，有时候需要合并最近的若干个 $\text{commit}$（例如在提 $\text{Pull Request}$ 前，可以将该特性分支的所有 $\text{commit}$ 合并为一个 $\text{commit}$，以便将来查看这个 $\text{Pull Request}$ 的变更）

要点

借助以下两个命令，可以将当前分支的最近 $\text{n}$ 个 $\text{commit}$ 合并成一个 $\text{commit}$

git reset --soft HEAD~n
git commit -m "Please write your commit message here"

请注意

• 执行第一个命令时，需要将 $\text{n}$ 替换为您需要的数字（例如 $\text{5}$）
• 执行第二个命令时，请将 "Please write your commit message here" 替换为合适的内容

正文

为了便于讨论，我们来杜撰一个例子 ⬇️

示例

准备工作

请将以下代码保存为 main.sh (具体的名称并不重要)

mkdir temp
cd temp

git init
echo "nothing here" >> README.txt
git add README.txt
git commit -m "initial commit"

BOUND=5

for ((i=1; i<=BOUND; i++))
do
    FILE_NAME="file_$i.txt"
    touch "$FILE_NAME"

    echo "This is file number $i" > "$FILE_NAME"
    echo "Created file: $FILE_NAME"
    
    git add "$FILE_NAME"
    git commit -m "Created file: $FILE_NAME"
done

echo "All files created successfully!"

通过执行下方的命令就可以运行 main.sh ⬇️

bash main.sh

运行完 main.sh 之后，当前目录中会多出一个 temp 目录。在当前目录执行 tree temp 后，应该可以看到如下的内容

temp
├── file_1.txt
├── file_2.txt
├── file_3.txt
├── file_4.txt
├── file_5.txt
└── README.txt

1 directory, 6 files

如果用 IntelliJ IDEA (Community Edition) 打开 temp 目录，应该可以看到类似这样的效果 ⬇️

从图中可以看到，我们一共创建了 $\text{6}$ 个 $\text{commit}$。如果我们想把最近的 $\text{5}$ 个 $\text{commit}$ 合并在一起，那么至少有两种方案 ⬇️

方案一：基于 $\text{git reset}$ 命令的解决方案

通过执行如下命令，可以切换到 temp 目录中 ⬇️

cd temp

执行如下命令，就可以将最近的 $\text{5}$ 个 $\text{commit}$ 合并为一个

git reset --soft HEAD~5
git commit -m "Please write your commit message here"

请注意

• 在第一个命令中，数字 $\text{5}$ 并没有特殊之处，您可以使用数字 $\text{n}$ 以合并最近的 $\text{n}$ 个 $\text{commit}$
• $\text{git commit}$ 命令的 $\text{-{}m}$ 选项之后，需要提供对应的 $\text{message}$

执行完上述两个命令后，借助 IntelliJ IDEA (Community Edition) 再次观察，结果符合预期 ⬇️

参考资料

关于 $\text{git reset}$ 命令的详细介绍，可以参考以下两个链接（两个链接来自同一个网站，第一个链接的内容是简体中文，第二个链接的内容是英文）

• # 7.7 Git 工具 - 重置揭密 👍
• # 7.7 Git Tools - Reset Demystified 👍