玩GitHub的小伙伴应该都见过，很多大佬的个人主页README里，都有炫酷的动态数据卡片：代码统计、提交热度、仓库数据、语言占比等等，而实现这一切的核心工具就是 github-readme-stats。
但很多人都会遇到一个致命问题：官方公共API访问频繁、配额不足、图片加载失败、卡片刷不出来。想要稳定展示个人GitHub数据，最好的解决方案就是自己私有化部署，全程免费、零服务器、5分钟即可完成，永久不限量使用。
今天这篇保姆级教程，手把手教你从零部署github-readme-stats，适配新手，一步不落！
一、什么是 github-readme-stats？
github-readme-stats 是一款开源免费的动态统计卡片工具，能够自动抓取你的GitHub账号数据，生成高颜值SVG卡片，支持多种样式自定义，可直接嵌入个人主页README、简历、博客中。
✅ 支持功能：
- GitHub 基础数据统计（粉丝、仓库、提交数、PR数）
- 常用编程语言热度统计卡片
- 年度提交热力图、打卡日历
- 仓库数据卡片（Star、Fork、Issue 统计）
- 数十种主题配色、自定义边框、图标样式
默认使用官方公共接口，缺点是多人共用、限流严重、加载卡顿，自建服务即可完美解决。
二、部署前置准备
本次采用 Vercel 免费部署（无服务器、免费额度足够、自动HTTPS、全球加速），全程无需购买服务器、无需配置环境。
所需账号：GitHub账号、Vercel账号（可直接GitHub快捷登录）
三、保姆级部署完整步骤
Step 1：Fork 官方源码仓库
1、打开官方开源仓库地址：https://github.com/anuraghazra/github-readme-stats
2、点击页面右上角 Fork 按钮，将项目复刻到自己的GitHub账号下
3、无需修改任何代码，直接等待Fork完成即可
为什么要Fork？ 只有复刻到自己账号的仓库，才能自主配置环境变量、绑定Vercel部署，实现私有化调用。
Step 2：生成 GitHub 私有令牌（PAT）
这一步是核心，用于解决API限流，让你的服务稳定抓取数据。
1、进入GitHub个人设置：点击头像 → Settings
2、下拉找到Developer settings → Personal access tokens → Tokens (classic)
3、点击Generate new token (classic)
4、令牌配置参数：
- Note：自定义名称（例如 readme-stats-deploy）
- Expiration：选择No expiration（永久有效，无需频繁更新）
- 权限勾选：仅勾选 public_repo 即可（最小权限，安全无风险）
5、拉到页面最下方，点击 Generate token
6、生成后会出现一串以 ghp_ 开头的密钥，立即复制保存！仅显示一次
Step 3：Vercel 一键部署项目
1、打开 Vercel 官网：https://vercel.com/，使用GitHub账号一键登录
2、首页点击 Add New Project（新建项目）
3、点击 Import Git Repository，导入刚才Fork到自己账号的 github-readme-stats 仓库
4、无需修改默认部署配置，直接下滑找到 Environment Variables（环境变量）
5、添加环境变量：
- Key：PAT_1（必须完全一致，大写无空格）
- Value：粘贴刚才复制的GitHub令牌（ghp_开头密钥）
6、点击 Deploy 开始自动部署
等待1-3分钟，页面显示 Successfully Deployed 即部署成功！
Step 4：获取专属私有API地址
部署完成后，点击 Vercel 项目仪表盘的 Visit 按钮，即可打开你的专属域名，格式如下：
这个域名就是你的私有API接口地址，后续所有卡片调用都用这个地址，彻底脱离官方公共接口。
四、替换接口，在README中使用自定义卡片
原本官方卡片地址：
替换为你的私有域名即可，用法完全一致，举几个常用示例：
1、个人数据统计卡片
2、常用语言统计卡片
3、仓库数据卡片
将代码复制到你的GitHub个人主页README中，等待10秒刷新，即可稳定加载，永不限流。
五、进阶优化 & 常见问题解决
1、开启自动更新（全程免维护）
Vercel 默认绑定GitHub仓库，当官方项目更新时，你只需同步自己Fork的仓库，Vercel会自动重新部署更新，无需手动操作。
2、解决偶尔加载缓慢问题
如果Vercel国内访问偶尔波动，可以配置自定义域名，或选择 Cloudflare Workers 轻量化部署方案，访问速度更稳定。
3、令牌失效/数据不更新
重新生成GitHub PAT令牌，在Vercel项目环境变量中更新 PAT_1，重新部署一次即可恢复。
4、样式自定义技巧
工具内置几十种热门主题：tokyonight、dark、radical、gruvbox 等，只需修改链接中 theme= 参数即可切换，还支持自定义边框、透明度、图标显示、数据排序等配置。
六、部署总结
自建 github-readme-stats 最大的优势就是 免费、稳定、不限流、高颜值、零维护。相比于直接使用官方公共接口，私有化部署彻底解决了卡片加载失败、空白、刷新不出数据的问题，让你的GitHub个人主页质感拉满。
整个流程仅需5分钟，一次部署永久使用，无论是个人展示、技术简历、博客装饰，都是性价比极高的小优化。
码字不易，欢迎点赞收藏！如果部署过程中遇到问题，欢迎评论区留言交流~
