如何修改已存在但未推送的提交信息？

技术背景

在使用Git进行版本控制时，提交信息是记录代码变更的重要依据。但有时我们可能会在提交后发现提交信息存在错误或需要补充，这时就需要对已存在的提交信息进行修改。若提交还未推送到远程分支，修改相对容易；若已推送，则需要更谨慎处理，避免影响其他开发者的工作。

实现步骤

修改最近一次提交信息

如果要修改最近一次提交的信息，可以使用以下命令：

1	`git commit --amend`

执行该命令后，会打开编辑器，允许你修改最近一次提交的信息。此外，你也可以直接在命令行中设置提交信息：

1	`git commit --amend -m "New commit message"`

但这种方式在输入多行提交信息或进行小修改时可能会比较麻烦。

修改已推送到远程分支的提交信息

如果提交已经推送到远程分支，在本地修改提交信息（如上述方法）后，还需要强制推送该提交：

1
2
3

git push <remote> <branch> --force
# 或者
git push <remote> <branch> -f

注意：强制推送会用本地分支的状态覆盖远程分支。如果远程分支上有本地分支没有的提交，这些提交将会丢失。同时，要谨慎修改已经与他人共享的提交，因为修改提交本质上会重写它们的SHA ID，这可能会给其他有旧提交副本的人带来问题。

交互式变基修改提交信息

使用交互式变基可以修改任何想要更新的提交信息，即使不是最新的提交。步骤如下：

执行以下命令，n 是你想要编辑的最后一个提交之前的提交数量：

1	`git rebase -i HEAD~n`

选择 e/r 来编辑提交信息。

处理多个分支上的旧提交信息修改

如果需要在多个分支上修改旧的提交信息，可以使用以下命令：

1	`git filter-branch -f --msg-filter 'sed "s/<old message>/<new message>/g"' -- --all`

-f：强制执行操作。
--：分隔 filter-branch 选项和修订选项。
--all：确保所有分支和标签都被重写。

核心代码

修改最近一次提交信息

1 2	`git commit --amend git commit --amend -m "New commit message"`

强制推送修改后的提交

1 2	`git push <remote> <branch> --force git push <remote> <branch> -f`

交互式变基

1	`git rebase -i HEAD~n`

处理多个分支上的旧提交信息修改

1	`git filter-branch -f --msg-filter 'sed "s/<old message>/<new message>/g"' -- --all`

最佳实践

在修改提交信息前，确保没有已暂存的工作副本更改，否则这些更改也会被提交。
避免修改已经推送到公共分支且被他人使用的提交信息，如果必须修改，要与团队成员充分沟通。
可以设置 git rerere 来自动解决变基时可能出现的冲突。

常见问题

强制推送导致远程分支上的提交丢失

强制推送会覆盖远程分支的状态，因此在执行强制推送前，要确保已经与团队成员沟通，确认是否可以覆盖远程分支。如果不小心丢失了提交，可以通过 git reflog 找到丢失的提交并恢复。

交互式变基时出现冲突

当使用 git rebase -i HEAD~n 时，可能会出现冲突。可以使用 git rerere 自动解决冲突，或者手动解决冲突后，使用 git rebase --continue 继续变基。

修改多个提交信息时 Sourcetree 失败

在使用 Sourcetree 修改多个提交信息时，可能会出现 Unable to create 'project_path/.git/index.lock': File exists. 的错误。建议一次只修改一个提交信息，这样可能更可靠。