之前一直疑惑为什么我在Windows环境下commits都没有被GitHub统计，而在Linux环境下的commits才被统计到了，于是问Google，参考文章,来是因为git初始化设定时没有设定正确的用户名和邮箱（主要是邮箱），具体可以参考GitHub官方写的help文档。

注：本文大部分参考自文章.

首先要弄明白什么是Contributions, GitHub help文档中提到：

Your profile contributions graph is a record of contributions you've made to GitHub repositories. Contributions are only counted if they meet certain criteria. In some cases, we may need to rebuild your graph in order for contributions to appear.

你的个人简介中的贡献图记录的是你给GitHub上的仓库的贡献。它仅仅只记录某些符合标准的commits。在某些情况下，我们需要重新建立你的贡献图以便让所有的贡献都显示出来。

什么commits会被统计？

官方文档Why are my contributions not showing up on my profile?.

  • Issues 和 pull requests
    • 这个操作是在一年之内
    • 这个操作是针对一个独立的仓库，不能是fork
  • Commits
    • 一年之内提交的commits
    • commits使用的email地址是与你的GitHub账号相关联的
    • 这些commits是在一个独立的仓库而不是fork仓库
    • 这些commits是在：
      • 在默认分支上（通常是master）
      • 在gh-pages分支(包含 Project Pages sites 的仓库)

此外，至少满足下面条件中的一个（主要针对你Commit的仓库不是你创建的）：

  • 你是这个仓库的协作者，或者是这个版本库的拥有组织中的一员
  • 你fork过这个仓库
  • 你对这个仓库发起过pull request或者issue
  • 你对这个仓库标记了Star

Contributions未被GitHub计入的几个常见原因

  • 进行Commits的用户没有被关联到你的GitHub帐号中。
  • 不是在这个版本库的默认分支进行的Commit。
  • 这个仓库是一个Fork仓库，而不是独立仓库。

排查方法

在的本地repo里用git log命令查看commit记录上的个人邮箱是否正确

补救措施

然而这也并不是没有补救办法的，GitHub官网上就有给出详细的补救过程，英语好的同学请自行移步 Changing author info，下面是简要步骤：

为改变已经存在的 commits 的用户名和/或邮箱地址，你必须重写你 Git repo 的整个历史。

Warning:这种行为对你的 repo 的历史具有破坏性。如果你的 repo 是与他人协同工作的，重写已发布的历史是一种不好的习惯。仅限紧急情况执行该操作。

使用脚本来改变某个repo的Git历史

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#!/bin/sh
git filter-branch --env-filter '
OLD_EMAIL="旧的Email地址"
CORRECT_NAME="正确的用户名"
CORRECT_EMAIL="正确的邮件地址"
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

note:执行这段脚本会重写 repo 所有协作者的历史。完成以下操作后，任何 fork 或 clone 的人必须获取重写后的历史并把所有本地修改 rebase 入重写后的历史中。

在执行这段脚本前，你需要准备的信息：

  1. Mac、Linux下打开Terminal，Windows下打开命令提示符（command prompt）
  2. 给你的repo创建一个全新的clone
    git clone -bare https://github.com/user/re.git
    cd re.git
  3. 复制粘贴脚本，并根据你的信息修改以下变量：旧的Email地址，正确的用户名，正确的邮件地址
  4. 执行脚本
  5. 用git log命令看看新 Git 历史有没有错误
  6. 把正确历史 push 到 GitHub
    git push --force --tags origin 'refs/heads/*'
  7. 删除本地clone

设置正确的个人信息

1
2
git config --global user.email "你的邮件地址"
git config --global user.name "你的GitHub用户名"