删除旧仓库后无法创建新仓库的GitHub Pages，如何复用免费额度？

核心问题排查 #

免费版GitHub账户支持1个用户/组织站点（格式为username.github.io或orgname.github.io），以及无限个项目站点（格式为username.github.io/repo-name）。出现升级提示大概率是旧站点记录未清除或域名绑定残留导致的系统冲突。

具体解决步骤 #

1. 彻底清除旧仓库的Pages记录 #

• 进入GitHub账户「Settings」→「Pages」页面，检查是否还有旧仓库的站点条目，如有则点击右侧「Remove」彻底删除。
• 等待10-15分钟，给GitHub系统留足缓存同步时间（缓存延迟是这类问题的常见诱因）。

2. 为新仓库配置Pages #

场景A：创建项目站点（非username.github.io格式）

• 打开新仓库的「Settings」→「Pages」
• 在「Source」选项中选择目标分支（通常是main或gh-pages）和目录（/root或/docs），点击「Save」即可生成站点，不会触发升级提示。

场景B：替换原用户站点（新仓库需命名为username.github.io）

• 确认旧的username.github.io仓库已彻底删除（包括回收站：进入「Your repositories」→ 点击「Deleted repositories」→ 找到旧仓库并永久删除）。
• 创建新仓库，必须严格使用username.github.io作为仓库名（用户名大小写需完全匹配）。
• 按照项目站点的配置步骤设置Source，等待系统生成站点。

3. 清理自定义域名残留（若之前绑定过） #

• 进入账户「Settings」→「Pages」→「Custom domain」，检查是否有残留域名记录，点击「Unlink」解除绑定。
• 同时登录域名服务商后台，删除指向旧GitHub Pages的CNAME或A记录（若该域名不再使用）。

4. 强制刷新系统缓存 #

若以上操作后仍提示升级，可尝试：

• 退出GitHub账户，清除浏览器缓存后重新登录。
• 用GitHub CLI执行命令gh repo edit <新仓库名> --enable-pages（需先安装CLI并完成登录）。

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