必须设对邮箱，否则github/gitlab会标记提交为“unverified”或灰色头像，因平台仅认注册邮箱；填错如user@localhost、带空格或域名无效均导致验证失败，正确做法是使用github的noreply邮箱并勾选隐私保护。
git config --global user.email 为什么必须设对
设错邮箱不会导致 commit 失败，但会让提交在 GitHub/GitLab 上显示为“unverified”或变成灰色头像（ghost），贡献记录不计入个人主页。关键不是“能不能用”，而是“平台认不认识你”。
常见错误包括：
- 填
user@localhost、test@example.com这类无效域名邮箱 —— GitHub 明确拒绝匹配 - 填了公司邮箱却往个人 GitHub 仓库 push —— 提交作者邮箱和账户注册邮箱不一致，直接标记为未验证
- 邮箱前后带空格，比如
" name@x.com "——git config user.email输出看似正常，但平台解析失败
验证方式不是只看命令输出，而是执行：git config --get-regexp user，确认值无引号、无空格、域名真实可路由。
怎么让个人邮箱不暴露在 git log 里
Git 本身不提供“隐藏邮箱”的机制 —— user.email 就是提交元数据的一部分，不可省略，也无法加密。所谓“隐私保护”，实际靠的是平台级设置。
GitHub 支持使用 noreply 邮箱（如 id+abcd1234@users.noreply.github.com），这个地址由 GitHub 自动为你生成，只用于接收通知，不对外公开真实邮箱。启用后，在 GitHub Settings → Emails 页面勾选 “Keep my email address private”，再把 git config --global user.email 设为该 noreply 地址即可。
注意：
- GitLab 类似，叫 “Private email”，路径是 Settings → Account → Private email
- 改完后旧 commit 不会自动更新邮箱，仅影响新提交
- 如果你用 Gitee 或其他平台，需查其是否支持类似 noreply 机制；不支持就只能手动用个人别名邮箱（如
zhangsan+github@gmail.com）配合过滤规则
多个账号混用时 git config --global 容易踩的坑
全局配置不是“万能默认”，而是“兜底 fallback”。一旦你在某个仓库里执行过 git config user.email（没加 --global），那这个仓库就永久锁定该邮箱，后续所有 commit 都走本地配置，哪怕你改了全局值也无效。
典型翻车场景：
- 先在公司项目里设了
git config user.email "work@corp.com"，之后切到个人项目，忘了清掉本地配置，结果个人提交也用了公司邮箱 - 用 VS Code 提交时终端是 PowerShell，但之前只在 Git Bash 里设过全局配置 ——
git config --list --show-origin会显示空，因为 PowerShell 下读的是另一套环境 - Windows 上装了 GitHub Desktop，它自带 Git，PATH 优先调用它的
git.exe，而它的系统级配置（C:\Program Files\Git\mingw64\etc\gitconfig）可能覆盖了你的用户级设置
最稳的隔离方案不是禁用 --global，而是用 includeIf 按路径加载不同配置文件。例如在 ~/.gitconfig 里写：
[includeIf "gitdir:~/work/"]
path = ~/.gitconfig-work
[includeIf "gitdir:~/personal/"]
path = ~/.gitconfig-personal
然后分别维护两个文件，各自定义 user.name 和 user.email。这样连 cd 都不用手动切，Git 自动识别路径生效。
改错邮箱后旧 commit 怎么补救
不能“修改”，只能“重写”。Git 的 commit 是 SHA-1 哈希锁定的，author 字段变了，哈希就变，等于全新对象。
分两种情况处理：
- 刚 commit 且没
git push：用git commit --amend --author="Correct Name <correct>" --no-edit</correct>立刻覆盖，安全无副作用 - 已 push 到远程：除非团队明确同意，否则不要
git push --force-with-lease。更现实的做法是往后新提交用正确邮箱，旧记录保持原样 —— 多数开源项目和公司流程都接受这种“历史不可篡改”原则
真正容易被忽略的是：即使你用 --amend 修正了 author，如果原始 commit 里还包含敏感信息（比如硬编码的 API key），光改 author 没用，必须用 git filter-repo 彻底从历史中剥离 —— 这是另一个维度的问题，和邮箱配置无关，但常被一并触发。
