Mac OS zsh环境提交commit到GitHub不显示Git贡献历史如何处理

问题根源 #

GitHub CLI（gh）的登录凭证仅用于验证代码推送权限，commit的贡献归属完全由Git本地配置的用户名和邮箱决定，和gh登录状态、zsh当前系统用户名无关联。新Mac设备初始化Git时未配置对应账号信息，会默认读取系统用户名生成提交信息，导致无法匹配到你的GitHub账号。

解决步骤 #

1. 检查当前Git配置

执行以下命令查看现有配置，确认user.name和user.email是否与你的GitHub账号绑定信息一致：

git config --list

注意：提交所用邮箱必须是GitHub账号内已完成验证的邮箱，否则无法计入贡献。

2. 配置全局Git用户信息（所有仓库生效）

全局配置后所有新仓库默认使用该身份提交，执行命令：

• git config --global user.name "你的GitHub用户名"
• git config --global user.email "你的GitHub已验证邮箱"

提示：如果需要隐藏个人真实邮箱，可填写GitHub提供的noreply匿名邮箱，该地址可在GitHub账号设置的「Emails」页面查询，格式通常为ID+用户名@users.noreply.github.com，使用该地址提交同样可以正常计入贡献。

3. 单个仓库单独配置（仅当前仓库生效）

如果部分仓库需要使用不同的账号身份，进入对应仓库目录后，去掉--global参数执行配置即可：

• git config user.name "你的GitHub用户名"
• git config user.email "你的GitHub已验证邮箱"

4. 修正历史提交的归属（可选）

如果需要将之前提交错误的记录计入贡献，按场景操作：

• 仅修正最近1次未推送的提交：
  执行命令：git commit --amend --reset-author --no-edit
• 修正已推送的历史提交：

  警告：该操作会修改历史提交哈希，仅可在个人独有的仓库/分支操作，否则会影响协作者的代码同步。
  执行以下脚本，将占位符替换为对应信息即可：

  git filter-branch --env-filter '
  OLD_EMAIL="之前错误的提交邮箱"
  CORRECT_NAME="你的GitHub用户名"
  CORRECT_EMAIL="你的GitHub已验证邮箱"
  if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]
  then
      export GIT_COMMITTER_NAME="$CORRECT_NAME"
      export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL"
  fi
  if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]
  then
      export GIT_AUTHOR_NAME="$CORRECT_NAME"
      export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL"
  fi
  ' --tag-name-filter cat -- --branches --tags
  

  完成后强制推送到远程：git push --force origin 对应分支名

验证效果 #

配置完成后新提交1次commit，执行git log -1查看Author字段是否为你的GitHub账号信息，推送后等待几分钟即可在GitHub贡献面板看到对应记录。

内容的提问来源于stack exchange，提问作者Anon