学习笔记

Commit、Push 和贡献格子,有什么不同?

在种下代码小花园之前,先分清三个容易混淆的统计口径。

Git学习记录

GitHub 主页上的一格格颜色,很像一片小花园。但在博客里展示这些数字之前,需要先弄清楚:它们到底在数什么?

Commit:一次代码提交

Commit 是 Git 中的一次提交记录。可以把它理解成给当前修改留下一个有说明的存档。

比如,完成一个按钮、修复一个样式问题,都可以各自形成一次 Commit。

Push:把本地记录推送到远端

Push 是将本地的提交等更新发送到远程仓库的操作。

一次 Push 可能包含多个 Commit。 如果本地已经做了三次提交,最后一起推送,提交数与推送次数就会不同。

本地:Commit A → Commit B → Commit C
操作:一次 Push
远端:收到这三次提交

平台贡献:按平台规则统计

平台主页的贡献数量有自己的规则,除了符合条件的代码提交,也可能包含 Issue、Pull Request 等活动。

因此,“平台贡献”“Commit 数量”和“Push 次数”应该使用不同的名称,不能直接互相替代。

小屋准备怎样展示

  • 平台贡献日历标明平台来源。
  • 自建 Push 日历从接入采集时持续保存记录。
  • GitHub 与 Gitee 分开统计,避免镜像同步导致重复相加。
  • 没有采集到的时间显示“未记录”。

这部分仍在后续建设计划中。目前网站先提供文章和项目展示,不用演示数字冒充真实活动。

继续阅读

具体的活动接口限制可以查阅 GitHub Events API 官方文档。Gitee 的接入方式可以参考 添加 Webhook。

写在 XingKuiJueLong 的小屋返回文章列表 ↑