Git配置用户名邮箱失败怎么办？

Question

问题：在使用 `git config --global user.name` 和 `git config --global user.email` 配置用户名和邮箱后，执行 `git commit` 时仍提示“Please tell me who you are”，或提交记录显示错误的用户信息。 可能原因包括：配置命令拼写错误、未正确使用 `--global` 或 `--local` 参数、配置作用域层级冲突、Shell 环境未刷新配置，或存在多个 Git 配置文件（如项目级 `.git/config` 覆盖全局设置）。此外，邮箱格式不合法或引号使用不当也可能导致配置未生效。如何排查并确保 Git 正确读取用户名和邮箱？

Answer 1

一、现象描述与初步排查

在使用 git config --global user.name "Your Name" 和 git config --global user.email "[e-mail]" 配置 Git 用户信息后，执行 git commit 时仍提示：

*** Please tell me who you are.
Run
  git config --global user.email "[e-mail]"
  git config --global user.name "Your Name"
to set your account's default identity.

或提交记录中显示错误的用户名/邮箱（如系统用户名、主机名等）。此类问题虽常见于新手，但在多环境协作、CI/CD 流水线或容器化部署中，资深开发者也常因配置层级混乱而踩坑。

首先应确认是否成功写入配置。可通过以下命令查看当前生效的用户名和邮箱：

1. git config user.name
2. git config user.email

注意：不带作用域参数时，Git 默认按 local → global → system 层级查找，若项目级配置存在但为空或无效，则可能跳过全局设置导致报错。

二、配置层级与作用域分析

Git 支持三种配置级别，优先级从高到低如下：

层级	配置文件路径	说明
local	.git/config（项目目录下）	仅对当前仓库生效
global	~/.gitconfig 或 ~/.config/git/config	对当前用户所有仓库生效
system	/etc/gitconfig	系统级，对所有用户生效

若在项目根目录中存在 .git/config 文件且包含空或错误的 [user] 配置项，将覆盖全局设置。例如：

[user]
    name = 
    email = invalid-email

此时即使全局配置正确，Git 仍会认为用户信息未设置。建议使用以下命令明确查看各层级配置：

• git config --local user.name
• git config --global user.name
• git config --system user.name（需权限）

三、常见错误与验证流程

以下是导致配置未生效的典型原因及排查步骤：

1. 拼写错误：检查命令是否误写为 --gloabl 或 user.naem。
2. 引号问题：若用户名含空格，必须使用引号包裹，否则只保存第一部分。
3. 邮箱格式非法：如缺少 @ 符号或域名部分，Git 不拒绝写入但提交时校验失败。
4. Shell 缓存或环境未刷新：在某些终端或脚本环境中，旧配置可能被缓存。
5. 多 Git 配置文件冲突：通过 git config --list --show-origin 可列出所有配置来源。

执行该命令后输出示例：

file:/home/user/.gitconfig    user.name=John Doe
file:/home/user/.gitconfig    user.email=john.doe@invalid
file:.git/config              user.name=
file:.git/config              user.email=

可见项目级配置覆盖了全局设置，且值为空，导致提交失败。

四、解决方案与最佳实践

针对上述问题，推荐以下解决流程：

1. 清除无效的本地配置：
   git config --local --unset user.name
git config --local --unset user.email
2. 重新设置全局配置并验证：
   git config --global user.name "Correct Name"
git config --global user.email "[e-mail]"
3. 验证最终生效值：
   git config user.name 和 git config user.email
4. 测试提交：
   echo "test" > test.txt && git add . && git commit -m "test commit"

对于团队协作场景，可结合 Git Hook 强制校验提交者信息，防止误用系统默认账户。

五、自动化诊断流程图

为快速定位问题，可参考以下 Mermaid 流程图进行逐层排查：

graph TD
    A[执行 git commit 提示未设置用户] --> B{运行 git config user.name}
    B -- 返回空值 --> C[检查 local 配置是否为空]
    B -- 返回错误值 --> D[检查各层级配置优先级]
    C --> E[执行 git config --local --unset user.name]
    D --> F[使用 git config --list --show-origin]
    F --> G[定位冲突配置文件]
    G --> H[修正或删除无效配置]
    H --> I[重新设置全局 user.name/email]
    I --> J[再次尝试提交]
    J --> K[成功提交]

该流程覆盖了从现象识别到根本解决的完整路径，适用于日常运维与故障响应。