必须配置user.name和user.email，否则git commit直接报错“commit is not possible because you have no identity”；git按本地→全局→系统顺序查找配置，任一位置配齐二者即可通过校验，但未配置则硬性拦截提交。
Git 提交前必须设置 user.name 和 user.email，否则直接报错：commit is not possible because you have no identity。这不是警告，是硬性拦截——没配好就根本写不出 commit。
为什么 git config --global user.name 必须先执行
Git 在提交时按顺序查找配置：当前仓库 .git/config → 全局 ~/.gitconfig → 系统 /etc/gitconfig。只要其中任一位置有完整的一对 user.name + user.email，就能过；但若全都没设，git commit 就会卡住并抛出 author 错误。
常见误判点：
- 只在 Git Bash 里执行了配置，但 VS Code 终端用的是 PowerShell —— 它们读的可能是不同环境下的
~/.gitconfig路径（尤其 Windows 上） - 复制命令时混入中文引号或全角空格，导致实际存入的是
" Your Name "（带前后空格），后续git config user.name输出能看到异常字符 - 以为
git config --list显示了值就万事大吉，其实它不告诉你这行配置来自哪个文件，容易误判生效层级
怎么验证 user.name 真正被读取了
别信自己敲过的命令，要查 Git 实际加载的是哪条配置、从哪个文件来的：
- 运行
git config --list --show-origin，它会明确输出每行配置的来源，例如：file:/home/you/.gitconfig user.name=Your Name - 在目标仓库内运行
git config user.name（不带--global），看返回值是否是你期望的；再单独跑git config --global user.name对比，确认没被本地配置意外覆盖 - 如果看到某条来自
file:C:\Users\XXX\AppData\Roaming\Git\config（旧版 Git for Windows 兼容路径），建议删掉该文件，统一用~/.gitconfig
user.name 的值到底该怎么填
Git 不校验真实性，也不联网验证，它只原样写进 commit 对象。但 GitHub/GitLab 等平台会拿这个邮箱去匹配你账户绑定的邮箱——不一致就显示为 “ghost” 或 “unverified”。所以填法很关键：
- 名字部分可自由填写，建议用真实姓名或常用昵称；含空格必须加英文双引号，比如
git config --global user.name "Zhang San" - 邮箱必须与你在代码托管平台注册并验证过的邮箱完全一致（包括大小写、前后空格）；推荐用
git config --global user.email "you@example.com"设置个人默认值 - 公司项目需用企业邮箱？进到该仓库根目录，去掉
--global单独配：git config user.email "work@company.com"，这条只写入.git/config，不影响其他仓库
改完 user.name 后，旧 commit 会自动更新吗
不会。Git 的 commit 是不可变对象，author 信息已固化在哈希里。修改历史 commit 的作者只能重写历史，且仅建议在未推送到远程前操作：
- 改最新一次：
git commit --amend --author="New Name <new>" --no-edit</new> - 改最近三次：
git rebase -i HEAD~3，把要改的行前面改成edit，保存后对每条执行git commit --amend --author="..." --no-edit，再git rebase --continue - 一旦
git push过去，其他人已拉取，就不该再重写 —— 强制推送（push --force）会破坏协作流
最容易被忽略的是：GitHub 只认 commit 对象里的 user.email 字符串是否与账户邮箱**逐字节一致**，哪怕多一个空格、少一个点，都不会关联上主页。
