· GitHub  · 3 min read

GitHub README Stats:让你的 GitHub 主页更有逼格

GitHub README Stats 是一个流行工具,能根据你的 GitHub 数据自动生成漂亮的 SVG 卡片,常用在个人 GitHub Profile README 中。

GitHub README Stats 是一个流行工具,能根据你的 GitHub 数据自动生成漂亮的 SVG 卡片,常用在个人 GitHub Profile README 中。

GitHub README Stats(https://github.com/anuraghazra/github-readme-stats)是一个流行工具,能根据你的 GitHub 数据自动生成漂亮的 SVG 卡片,常用在个人 GitHub Profile README 中。

主要功能

  • Stats Card:显示总 Stars、Commits、PRs、Issues 等数据,右上角还有一个 贡献等级(Rank)
  • 其他卡片:Streak(连续打卡)、Top Languages、Trophies 等。

关于 Rank 等级(很多人会困惑)

项目采用类似日本学业评级的方式计算:

  • S:全球前 1%
  • A+ / A / A-:较好水平(A 大约是前 25%~37.5%)
  • B+ / B / B-:中等
  • C+ / C:最常见(很多人默认显示 C)

我之前遇到的情况:用官方公共实例时显示 C,后来换了镜像实例后变成了 A。这是因为不同实例的缓存、是否使用 GitHub Token、统计范围(public/private)不同,导致计算结果有差异。公共实例(vercel.app)经常因为负载高或限流而崩掉(503),所以很多人选择自部署或找稳定镜像。

部署建议(2026 年)

  • 最简单:用社区基于 Cloudflare Workers 做的替代方案,速度快、稳定,不容易崩。
  • 自己部署:可以尝试 fork 原仓库部署到 Cloudflare Workers(用 wrangler),或继续用 Vercel。但 Workers 配置比 Vercel 稍复杂,需要注意环境变量(PAT Token)和依赖打包。
  • 我的博客用 Cloudflare Pages 托管静态内容,这个 Stats Card 则是独立的动态图片,直接把生成后的链接嵌入 README.md 即可。

其他工具推荐

  • GitHub Card (https://githubcard.com): 一个功能类似但提供更多自定义选项的工具。它提供了一个在线 Canvas 编辑器,可以让你像做 PPT 一样拖拽、调整卡片样式,非常灵活。

示例用法:

<image-card alt="GitHub Stats" src="https://你的stats链接?username=你的用户名&theme=github_dark" ></image-card>
Back to Blog

Related Posts

View All Posts »