必须在首次提交前用git config --global user.name "name"和git config --global user.email "email"设置，否则后续修改不更新历史；漏--global、写错参数或本地配置为空均会导致“please tell me who you are”错误。
git config --global user.name 和 user.email 怎么设才生效
全局提交者信息只在首次提交前设置才可靠，后续修改不会自动更新历史记录中的作者字段。执行命令时必须带 --global 参数，否则只影响当前仓库（.git/config），容易误以为设好了但换个项目又弹出警告。
常见错误是漏掉双破折号，写成 git config -global，这会报错“unknown option”。还有人把邮箱写成 user@localhost 这类无效格式，导致某些平台（如 GitHub）无法关联贡献记录。
- 正确写法：
git config --global user.name "Zhang San" git config --global user.email "zhangsan@example.com"- 验证是否成功：
git config --global user.name和git config --global user.email
为什么设置了 global 还提示 “please tell me who you are”
这个错误说明 Git 当前没拿到可用的 author 信息，优先级顺序是：仓库本地配置 > 系统级配置 > 全局配置。如果当前项目 .git/config 里有 [user] 段但值为空或注释掉了，Git 就会忽略全局设置，直接报错。
另一个高发场景是用了 git clone 后立刻 git commit，但该仓库被其他人初始化过，并手动清空了 user 配置——这时候 git config --list --show-origin 能看到冲突来源。
- 检查当前生效的配置：
git config --get-regexp user - 删掉干扰的本地配置：
git config --unset user.name（在仓库根目录下运行） - 注意 Windows 用户可能被 Git for Windows 的系统级 config 干扰，路径通常是
C:\Program Files\Git\mingw64\etc\gitconfig
多账号场景下怎么避免 push 错仓库（比如公司邮箱推到 GitHub 个人库）
全局配置无法区分不同远程地址，硬靠 --global 会导致所有仓库共用同一组 identity，这是最常踩的坑。解决方案不是禁用 global，而是用条件性覆盖：在特定仓库里用 git config user.email（不加 --global）设为对应账号邮箱。
更稳妥的做法是启用 Git 的 includeIf 功能，按路径自动加载不同配置。例如把工作项目放在 ~/work/ 下，个人项目在 ~/personal/，就可以在 ~/.gitconfig 里写：
[includeIf "gitdir:~/work/"]
path = ~/.gitconfig-work
[includeIf "gitdir:~/personal/"]
path = ~/.gitconfig-personal
然后分别维护两个文件，各自定义 user.name 和 user.email。注意路径末尾斜杠不能少，且需用正斜杠（Windows 也一样）。
commit 之后发现 author 写错了还能改吗
刚提交（未 push）时可以用 git commit --amend --author="New Name <new>"</new> 覆盖；但如果已经 push，强行 amend 再 force-push 会破坏协作历史，不推荐。更安全的方式是后续提交里用 git commit --author="..." 显式指定，GitHub/GitLab 会识别并显示正确归属。
真正麻烦的是批量修正——比如某次脚本误用了错误邮箱，提交了几十次。这时得用 git filter-repo（官方推荐替代 filter-branch 的工具），但它会重写整个历史 SHA，所有协作者都得重新 clone。
所以别指望事后补救，重点是把全局配置 + 条件 includeIf 搭好，再配合 pre-commit 钩子校验邮箱域名，这才是可持续的方案。
