又提交错了！Git 多身份管理最佳实践：从错误提交到条件包含的完整解决方案

好的，这是一个在 Git 中很常见但又比较棘手的问题，因为你已经将错误的提交 push 到了远程仓库。修改已经公开的历史记录需要谨慎操作，特别是当有其他人和你一起协作时。

别担心，这个问题完全可以解决。我将为你提供两种方案：

1. 方案一：只修改最后一次提交 (最简单、最常见的情况)

2. 方案二：修改历史上的多次提交 (更复杂的情况)

在操作之前，请务必阅读以下重要提示：

警告

以下操作会重写（rewrite）远程仓库的历史记录。如果你正在一个团队中工作，请务必先和你的同事沟通。因为强制推送（force push）会让他们本地的仓库历史与远程仓库产生冲突，他们需要执行额外的命令来同步。

方案一：只修改最后一次提交

如果只有刚刚推送的最后一次提交是错误的，这是最简单的情况。

步骤 1: 修改最近一次提交的作者信息

在你的本地仓库中，使用 git commit --amend 命令来修改最后一次提交。 我们将使用 GIT_COMMITTER_NAME 和 GIT_COMMITTER_EMAIL 环境变量来临时覆盖当前的 Committer 设置。

1# --amend 会打开上次的提交信息编辑器，但我们不修改提交信息
2# --author 会直接修改作者信息
3# --no-edit 表示你不想修改提交信息，直接使用上一次的
4GIT_COMMITTER_NAME="你的正确用户名" GIT_COMMITTER_EMAIL="你的正确邮箱地址" git commit --amend --author="你的正确用户名 <你的正确邮箱地址>" --no-edit

执行后，你本地的最后一次提交就已经被修正了。

步骤 2: 强制推送到远程仓库

因为你修改了本地的历史记录，所以它和远程仓库的历史记录已经不一致了。你不能使用 git push，而必须使用强制推送。

推荐使用 --force-with-lease，它比 --force 更安全，因为它会检查远程分支在你上次拉取之后是否被其他人更新过。

1git push --force-with-lease

完成！现在远程仓库上最后一次提交的作者信息已经被修正了。

在不同的项目目录（例如"工作"目录和"个人项目"目录）下自动切换 Git 身份（用户名和邮箱），是一个非常棒的实践！可以有效避免将个人邮箱提交到公司项目这种尴尬的事情。

Git 通过一个叫做 “条件包含” (Conditional Includes) 的功能完美地解决了这个问题。这个功能自 Git 2.13 版本开始提供，现在基本已经是标配了。

它的原理是：在你的全局 ~/.gitconfig 文件中设置一个条件，当你的 Git 仓库路径满足这个条件时，Git 就会加载一个额外的、特定的配置文件，从而覆盖全局配置中的身份信息。

下面是详细的设置步骤，我们以一个常见的"工作" vs “个人"场景为例。

场景假设

假设你的电脑目录结构如下：

• 所有工作项目都存放在 ~/dev/work/ 目录下。
• 所有个人项目都存放在 ~/dev/personal/ 目录下。

步骤 1：为每个身份创建独立的配置文件

首先，我们为不同的身份创建不同的配置文件。这些文件可以放在你主目录的任何位置，通常我们把它们和 ~/.gitconfig 放在一起，并以 .gitconfig- 作为前缀，方便管理。

1. 创建工作身份的配置文件 ~/.gitconfig-work 在终端执行以下命令，或者直接创建并编辑这个文件：

1# 在 ~/.gitconfig-work 文件中写入以下内容
2cat > ~/.gitconfig-work << EOF
3[user]
4    name = 你的工作用户名
5    email = 你的工作邮箱@work.com
6EOF

1. 创建个人身份的配置文件 ~/.gitconfig-personal 同样地，为你的个人身份创建一个文件：

1# 在 ~/.gitconfig-personal 文件中写入以下内容
2cat > ~/.gitconfig-personal << EOF
3[user]
4    name = 你的个人用户名
5    email = 你的个人邮箱@personal.com
6EOF

现在你有了两个独立的身份配置文件。

步骤 2：修改你的主配置文件 ~/.gitconfig

接下来，编辑你的全局主配置文件 ~/.gitconfig，告诉 Git 何时使用上面创建的那些文件。

1. 设置一个默认身份 首先，在 ~/.gitconfig 中设置一个你最常用的或者作为"默认"的身份。当项目路径不满足任何特殊条件时，Git 就会使用这个身份。我们假设内容为空也完全可以。

1[user]

如果你的 ~/.gitconfig 已经有 [user] 配置，请确保它是你想要的默认配置。

1. 添加 includeIf 条件 在 ~/.gitconfig 文件的末尾，添加 [includeIf] 部分。

1# 当仓库路径在 ~/dev/work/ 目录下时，加载工作配置文件
2[includeIf "gitdir:~/dev/work/"]
3path = ~/.gitconfig-work
4
5# 当仓库路径在 ~/dev/personal/ 目录下时，加载个人配置文件
6[includeIf "gitdir:~/dev/personal/"]
7path = ~/.gitconfig-personal

注意

gitdir: 后面的路径末尾一定要有斜杠 /，这确保了它匹配的是目录，而不是同名的文件。~/ 是你主目录的简写，Git 可以识别它。

如何验证配置是否生效

验证非常简单：

1. 进入工作目录下的一个 Git 仓库：

1cd ~/dev/work/some-work-repo

1. 检查当前的 user.email：

1git config user.email

输出应该是你的工作邮箱 (你的工作邮箱@work.com)。

1. 进入个人项目目录下的一个 Git 仓库：

1cd ~/dev/personal/some-personal-repo

1. 再次检查当前的 user.email：

1git config user.email

输出应该是你的个人邮箱 (你的个人邮箱@personal.com)。

通过这种方式，你就可以一劳永逸地解决多身份管理问题。只要你把项目放在正确的父目录下，Git 就会自动为你选择正确的身份进行提交。

注意

此设置只对未来的新提交有效，不会修改任何已经存在的提交历史。如果需要修改历史提交，你仍然需要使用我们之前讨论过的 git rebase 或 git commit --amend 等方法。

梳理 SSH 配置 (~/.ssh/config)

你当前的 SSH 配置已经很不错了，我们只是让它更清晰。Host * 的配置意味着默认所有 SSH 连接都尝试通过 1Password 代理，这正好可以作为你的工作/默认 SSH 设置。而 github.com-personal 则明确使用了一个独立的密钥文件，这是你的个人 SSH 设置。我们保持这个结构。

你的 ~/.ssh/config 文件基本不用动，它已经完美地区分了两种 SSH 连接方式。

修改独立的 Git 身份文件

现在，我们修改对应的 Git 配置文件。

1. 修改个人身份文件 (~/.gitconfig-personal)

这个文件不仅要定义你的用户名和邮箱，最好还能自动将 github.com 的地址"翻译"成使用你个人 SSH 别名的地址。这样你就不用每次都手动修改 remote url 了。

1# 在后面加入
2
3# 魔法发生的地方：
4# 当在这个目录下，所有 github.com 的 SSH 地址
5# 都会被自动替换成使用 github.com-personal 这个别名
6[url "[email protected]:"]
7    insteadOf = [email protected]:
8EOF

这个 url...insteadOf 的配置非常强大，意味着以后你即使用标准地址 git clone [email protected]:CheerChen/some-repo.git，只要你当前在 ~/dev/personal/ 目录下，Git 也会自动用 github.com-personal 的别名去连接，从而用上正确的 SSH 密钥。

1. 无需修改工作身份文件 (~/.gitconfig-work)

注意

工作配置里我们不需要 url...insteadOf，因为它会使用默认的 github.com，并通过 Host * 的设置走 1Password 代理，这正是我们想要的。

清理战场：移除旧的项目内配置

最后一步，就是把你那些"可能有也可能没有"的项目内 [user] 设置全部清理掉，让新的自动化系统接管。

1. 移除项目内的 user 配置：

1# --local 表示只操作当前项目内的 .git/config 文件
2git config --local --unset-all user.name
3git config --local --unset-all user.email

执行后，这个项目就不会再有自己的 [user] 设置了。

1. （推荐）修正 remote URL：

因为你设置了 url...insteadOf 规则，你不再需要在 remote url 里写死 github.com-personal 了。把它改回标准的地址，这样你的项目更有移植性。

 1# 查看当前的 remote url
 2git remote -v
 3# output: origin  [email protected]:CheerChen/konakore.git (fetch)
 4# ...
 5
 6# 将其修改为标准地址
 7git remote set-url origin [email protected]:CheerChen/konakore.git
 8
 9# 再次查看，确认修改成功
10git remote -v
11# output: origin  [email protected]:CheerChen/konakore.git (fetch)
12# ...

1. 最终验证：

在这个项目目录下，运行：

1# 检查 Git 会使用哪个邮箱
2git config user.email
3
4# 测试 push/pull 是否仍然能用正确的 SSH 密钥
5git fetch

对你其他的项目也重复执行，逐个清理，最终你的所有 Git 操作都会根据项目所在的目录自动切换身份，无需任何手动干预。