掌握 Git 用户配置：姓名、邮箱和编辑器默认设置

Git 用户配置看起来枯燥无味，直到你第一次发现工作提交显示错误的邮箱地址、公司贡献图缺失一半更改，或者 Git 打开了一个你不知道如何退出的编辑器。解决方法通常很简单：有意识地设置姓名、邮箱和编辑器，然后知道如何为单个仓库覆盖这些设置。

重要的不是记住每个 git config 标志，而是理解 Git 从哪里读取配置，以及如何在提交前检查 Git 将使用的最终值。

---

理解 Git 配置层级

Git 采用配置文件的层级结构。在较高层级定义的设置可以被较低层级的设置覆盖。理解这些层级可以让你精细或全局地应用设置。

有三个主要的配置层级：

1. 系统级 (--system)：应用于整个机器上的每个用户和每个仓库。除非管理专用构建服务器，否则很少用于用户身份。
2. 全局级 (--global)：应用于当前用户在机器上的所有仓库。通常在此设置主要的 user.name 和 user.email。
3. 本地级 (--local)：仅应用于当前所在的特定仓库。允许为特定项目（例如工作 vs 个人）使用不同身份。

查看当前配置设置

在更改之前，查看 Git 当前配置的内容很有帮助。你可以列出所有层级或特定层级的设置：

# 查看所有层级的所有设置
git config --list

# 仅查看全局设置
git config --global --list

---

配置用户身份（姓名和邮箱）

姓名和邮箱地址是 Git 中存储的最关键的用户信息。它们标识谁做出了更改。

1. 设置全局用户身份

对于大多数用户，建议第一步全局设置姓名和邮箱。这确保你所有未来的项目都携带此默认身份。用你的实际信息替换占位符。

设置姓名：

git config --global user.name "你的全名"

设置邮箱：

强烈建议使用与 GitHub/GitLab/Bitbucket 账户关联的邮箱地址，特别是如果你使用 SSH 密钥或提交签名。

git config --global user.email "[email protected]"

最佳实践： 使用与托管提供商绑定的确切邮箱地址，以确保贡献在远程平台上正确显示。

2. 为特定仓库覆盖身份（本地级）

有时，你可能需要为某个项目贡献时使用特定的归属（例如，为客户仓库使用工作邮箱）。你可以在该仓库内覆盖全局设置。

导航到仓库根目录并运行配置命令，不带 --global 标志：

# 导航到项目目录
cd ~/projects/client-project-alpha

# 为此仓库设置特定名称
git config user.name "工作名称"

# 为此仓库设置特定邮箱
git config user.email "[email protected]"

当你在此仓库内提交时，Git 将使用这些本地设置而不是全局设置。

Git 如何选择身份

当 Git 处理提交时，它按顺序检查层级：本地 -> 全局 -> 系统。它找到的第一个 user.name 或 user.email 设置就是使用的那个。

---

配置默认文本编辑器

当 Git 需要你输入时——例如编写提交消息、变基指令或合并冲突解决注释——它会打开你配置的文本编辑器。默认情况下，这可能是像 vi 或 vim 这样的基本终端编辑器，对新用户来说可能具有挑战性。

设置全局编辑器偏好

你可以使用 --global 标志配置 Git 在所有机器或项目中使用你偏好的编辑器。

使用 VS Code 作为编辑器

如果你偏好 Visual Studio Code 并已安装命令行集成 (code)，按如下方式设置：

git config --global core.editor "code --wait"

--wait 标志至关重要；它告诉 Git 暂停执行，直到你关闭在 VS Code 中打开的文件，确保提交消息最终确定。

使用 Sublime Text 作为编辑器

对于 Sublime Text 用户：

git config --global core.editor "subl -n -w"

使用 Nano 或 Vim（如果已熟悉）

如果你偏好简单的终端编辑器：

# 对于 Nano
git config --global core.editor "nano"

# 对于 Vim（通常是默认）
git config --global core.editor "vim"

测试编辑器配置

测试编辑器配置是否正常工作的最简单方法是发起一个需要消息的修改，或者创建一个不带 -m 标志的提交：

# 创建一个虚拟文件并尝试不带 -m 提交
touch tempfile.txt
git add tempfile.txt
git commit 
# 这应该会打开你新配置的编辑器。

---

修复现有错误身份

更改 user.name 和 user.email 会影响未来的提交。它不会重写已存在的提交。如果你的上一个提交有错误的作者且尚未推送，你可以在修复配置后修改它：

git config user.name "正确名称"
git config user.email "[email protected]"
git commit --amend --reset-author

如果错误的提交已推送到共享分支，请小心。重写已发布的历史可能会干扰其他人。对于私有分支，修改和强制推送可能是可接受的：

git push --force-with-lease

对于共享分支，更安全的做法通常是保留历史记录，并为未来提交修复身份。如果需要修复多个提交，请在与团队协调后使用历史重写工具。

检查值的来源

当 Git 行为异常时，git config --list 可能过于嘈杂。使用 --show-origin 让 Git 告诉你哪个文件提供了每个值：

git config --show-origin --list

你可能看到类似以下的输出：

file:/Users/alex/.gitconfig    [email protected]
file:.git/config               [email protected]

这意味着在当前仓库中，仓库本地值胜出。这是诊断“我更改了全局邮箱但 Git 仍然使用旧邮箱”的最快方法。

你也可以查询单个值：

git config --show-origin user.email

一个持久的工作和个人设置

一种常见模式是保留个人全局身份并在本地覆盖工作仓库：

git config --global user.name "Alex Rivera"
git config --global user.email "[email protected]"

cd ~/work/payments-api
git config user.email "[email protected]"

一些团队偏好将不同克隆放在不同目录下。较新版本的 Git 支持条件包含，可以自动加载路径下仓库的工作配置：

# ~/.gitconfig
[user]
    name = Alex Rivera
    email = [email protected]

[includeIf "gitdir:~/work/"]
    path = ~/.gitconfig-work

# ~/.gitconfig-work
[user]
    email = [email protected]

不同平台上确切的路径匹配规则可能有些令人惊讶，所以在实际仓库中测试它：

cd ~/work/some-repo
git config --show-origin user.email

可以避免的编辑器问题

core.editor 设置主要在 Git 需要消息或指令文件时起作用：合并提交、交互式变基、提交修改以及不带 -m 的提交。如果 Git 打开 Vim 而你对此不熟悉，可能会感觉命令卡住了。

对于 VS Code，--wait 标志不是可选的：

git config --global core.editor "code --wait"

没有 --wait，Git 可能会打开文件并立即继续，然后你才写完消息。对于仅终端的服务器，nano 通常不那么令人惊讶：

git config --global core.editor "nano"

你可以在不创建实际项目更改的情况下测试编辑器：

git commit --allow-empty

编写测试消息，保存，然后删除空提交（如果你不想要它）：

git reset --soft HEAD~1

提交签名和托管账户

你的 Git 邮箱与身份验证是分开的。SSH 密钥、个人访问令牌和浏览器登录决定你是否能推送。user.email 决定写入提交对象的作者邮箱。

托管提供商通常通过邮箱地址将提交匹配到你的账户。如果你使用隐私邮箱，请设置确切的地址：

git config --global user.email "[email protected]"

如果你的组织要求签名提交，身份只是设置的一部分。你可能还需要 user.signingkey、commit.gpgsign 或 SSH 签名配置。将其与基本的姓名/邮箱设置分开，以便一次调试一层。

作者、提交者和环境覆盖

Git 在每个提交上存储作者和提交者。大多数情况下他们是同一个人。当有人应用另一个开发者的补丁、变基提交或修改最初由其他人编写的提交时，他们会不同。

你可以使用以下命令查看这两个字段：

git log --format=fuller -1

当有人说“Git 使用了错误的邮箱”但正常的单行日志只显示作者时，这个输出很有用。提交者可能不同，因为维护者应用了补丁，或者因为变基重新创建了提交。

Git 也可以从环境变量读取身份：

GIT_AUTHOR_NAME="构建机器人" \
GIT_AUTHOR_EMAIL="[email protected]" \
git commit -m "更新生成的文件"

CI 系统有时使用这种模式。当有意使用时没问题，但当管道将这些变量泄漏到开发者 shell 或本地脚本中时会令人困惑。如果 Git 忽略你的配置，请检查环境：

env | rg '^GIT_(AUTHOR|COMMITTER)'

在提交前取消意外的覆盖：

unset GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL

防止混乱历史的小团队策略

对于团队来说，最好的 Git 用户配置策略通常很短：

• 使用你的真实姓名或团队识别的相同标识。
• 对公司仓库使用公司邮箱。
• 使用已验证的托管提供商邮箱，以便提交附加到正确的账户。
• 除非团队同意，否则不要重写共享历史来清理旧的作者元数据。
• 仅当你的入职脚本依赖它时，才记录首选的 core.editor。

你可以为邮箱域添加预提交或预推送检查，但要保持友好。一个阻止每次提交的本地钩子（因为有人从不同机器配对）会造成摩擦。服务器端策略或受保护分支上的 CI 检查通常更容易管理。

这是一个简单的本地检查，你可以在推送工作代码前手动运行：

git config user.email
git log --format='%h %ae %s' origin/main..HEAD

如果任何提交在公司分支上显示个人邮箱，在打开拉取请求前修复它。这比以后修复合并的分支容易得多。

常见配置意外的故障排除

如果 git config --global user.email 显示正确的值，但提交仍然使用其他内容，请检查你是否在具有本地覆盖的仓库内：

git config --local user.email
git config --show-origin user.email

如果本地值错误，替换它或取消设置它：

git config user.email "[email protected]"
git config --unset user.email

取消设置本地值会使 Git 再次回退到全局值。这通常比在每个仓库中设置相同的值更干净。

如果 Git 显示 Author identity unknown，意味着 Git 无法从配置或环境中找到可用的 user.name 和 user.email。设置两者，而不仅仅是一个：

git config --global user.name "Alex Rivera"
git config --global user.email "[email protected]"

在共享服务器上，除非你为所有人管理机器，否则避免使用 --system。系统级身份可能使不相关的用户意外地以同一个人提交。构建代理是主要例外，即使在那里，通常也最好显式配置 CI 工作区或服务账户。

快速检查清单

• 使用 git config --global 进行适用于所有地方的设置，例如默认身份和编辑器。
• 在仓库内使用 git config（不带标志）来本地覆盖全局设置。
• 当需要知道哪个文件胜出时，使用 git config --show-origin --list。
• 仅在适当重写最近提交时使用 git commit --amend --reset-author。
• 配置图形编辑器时使用 --wait，以便 Git 等待你完成编辑。