如何修改git的commit消息

修改 Git commit 消息（提交说明）主要分为三种情况，请根据你的具体场景选择对应的方法：

情况一：只修改"最近一次"提交 (最常用)

如果你刚刚提交完代码，发现写错了，且还没有推送到远程仓库 ，可以使用 --amend 命令。

1. 在终端输入：

   git commit --amend

2. 这会打开你的默认文本编辑器（如 Vim 或 Nano）。

3. 修改第一行的提交信息。

4. 保存并退出编辑器。

   • Vim 操作提示：按 i 进入编辑模式 -> 修改文字 -> 按 Esc -> 输入 :wq 回车保存。

快捷方式（不打开编辑器）：

如果你只想用一行命令快速修改：

git commit --amend -m "这里写新的提交信息"

---

情况二：修改"旧的"或"多个"提交

如果你想修改的不是最后一次提交，而是倒数第二次、第三次，或者很久以前的提交，需要使用交互式变基（Interactive Rebase）。

假设你想修改最近 3 次提交中的某一个：

1. 启动变基：

   git rebase -i HEAD~3

2. 你会看到一个编辑器界面，列出了最近的 3 次提交，格式如下：

   pick f7f3f6d changed my name a bit
   pick 310154e updated README formatting and changed origin
   pick a5f4a0d added cat-file

3. 关键步骤： 找到你想修改的那行，把开头的 pick 改为 reword (或者简写为 r)。

   • 注意：不要修改后面的提交信息，只改命令词。

4. 保存并退出编辑器。

5. Git 会自动暂停在你标记为 reword 的那个提交上，并再次打开编辑器让你修改具体的 Commit 消息。

6. 修改消息，保存并退出。

7. Git 会自动继续处理剩下的提交，直到完成。

---

情况三：已经推送到远程仓库 (Remote)

警告：这是一个危险操作！

如果你已经把代码 git push 到了远程（比如 GitHub/GitLab），再修改本地的 commit 消息会导致本地和远程的历史不一致。

1. 先按照情况一 或情况二的方法在本地修改好消息。

2. 使用强制推送（Force Push）覆盖远程分支：

   git push origin <你的分支名> --force
   # 或者更安全一点的写法（推荐）：
   git push origin <你的分支名> --force-with-lease

风险提示： 如果你是和别人协作开发，千万不要强制推送修改过的公共分支历史。这会导致你同事的代码库出现严重冲突。只有在你独自使用的分支上才建议这么做。

总结

场景	命令	备注
刚提交，未推送	git commit --amend	最安全、最简单
修改历史中的某次	git rebase -i HEAD~N	把 pick 改为 reword
已推送到远程	修改后 git push --force	慎用，仅限个人分支

还有两种工具主要用于批量修改 历史记录。如果你需要修改全部 或者一大批 commit 消息（例如：给所有过去的提交都加上 Jira 编号，或者批量替换掉某个敏感词），那么 rebase -i 会太慢太累，这时候就需要用到 filter。

以下是两种方法的详细说明：

---

方法一：使用 git filter-branch (原生，但已弃用)

这是 Git 自带的命令，不需要安装额外软件。但官方已经弃用（Deprecated），因为它速度慢且容易出错。不过对于简单的文本替换，它依然有效。

你需要使用 --msg-filter 参数，它会把每一条 commit 消息传递给一个 shell 命令（通常是 sed）来处理。

场景 A：批量替换文字

假设你想把历史记录中所有的 "bug fix" 替换为 "Fix(core)"：

git filter-branch --msg-filter 'sed "s/bug fix/Fix(core)/g"' -- --all

• sed "s/旧文字/新文字/g"：这是 Linux 的流编辑器命令，用于替换文本。
• -- --all：表示对所有分支和标签进行操作。

场景 B：给所有提交加前缀

假设你想给所有提交消息前面加上 [Project-A]：

git filter-branch --msg-filter 'cat && echo " [Project-A]"' -- --all

(注意：sed 处理多行比较麻烦，简单的追加可以用 cat 配合 echo)

清理备份：

执行完 filter-branch 后，Git 会在 .git/refs/original/ 下保留备份。确认无误后，可以删除备份以减小体积：

rm -rf .git/refs/original/
git reflog expire --expire=now --all
git gc --prune=now

---

方法二：使用 git filter-repo (推荐，现代工具)

这是目前官方推荐的工具，基于 Python 编写，速度极快且更安全。
前提： 你通常需要先安装它（它不是 Git 默认自带的）。

• Mac: brew install git-filter-repo
• Pip: pip install git-filter-repo

场景：批量修改 Commit 消息

git filter-repo 使用 Python 代码片段来处理消息，这比写 Shell 脚本更灵活。

假设我们要把所有包含 "foo" 的消息改成 "bar"：

git filter-repo --message-callback '
  return message.replace(b"foo", b"bar")
'

或者，如果你想给所有消息加上前缀 [DEV] ：

git filter-repo --message-callback '
  return b"[DEV] " + message
'

• 注意：在 Python 回调中，message 是字节串（bytes），所以字符串前面要加 b。

---

⚠️ 极度重要的警告

无论你使用 filter-branch 还是 filter-repo，请务必注意以下几点：

1. 哈希值（SHA-1）会全部改变：

   修改 commit 消息本质上是生成了全新的 commit。这意味着你项目的所有历史记录 ID 都会变。

2. 破坏协作：

   如果你的代码已经推送到公共仓库，并且有同事基于你的分支在开发，绝对不要擅自执行此操作。这会导致他们的代码库与远程仓库彻底冲突。

   • 只有在你完全掌控该仓库，或者通知了所有同事重新 clone 代码的情况下才能做。

3. 强制推送：

   修改完成后，你需要强制推送到远程：

   git push origin --force --all

总结

• 如果你只想改最近的一两个： 用 git commit --amend 或 git rebase -i。
• 如果你要改几百个（批量处理）：
  • 如果不想装新软件，用 git filter-branch --msg-filter。
  • 如果追求速度和安全（推荐），装一个 git filter-repo。