重命名GitHub Pages仓库后Workflow失败：链接不存在

1. 核对站点基础配置 #

进入仓库的「Settings」→「Pages」页面：

• 确认Source区域的分支、目录设置和之前一致（比如是否选择gh-pages分支，或是主分支的/docs目录）
• 若之前绑定了自定义域名，需更新为新的lastname.github.io，或重新完成域名验证流程

2. 修正Workflow配置中的旧仓库名 #

打开.github/workflows下的部署脚本文件：

• 替换所有硬编码的username.github.io为lastname.github.io（比如站点URL、部署目标地址等字段）
• 保存修改后重新推送代码，触发Workflow执行

3. 确认远程仓库源已更新 #

本地终端执行命令检查远程源状态：

git remote -v

若输出仍显示旧仓库地址，重新设置远程源：

git remote set-url origin https://github.com/你的用户名/lastname.github.io.git

执行完成后再次推送代码到新仓库

4. 清理部署缓存并重跑Workflow #

• 进入仓库的「Actions」页面，找到失败的Workflow记录，点击「Re-run jobs」重新执行
• 若问题持续，手动删除gh-pages分支（如果使用该分支部署），再触发Workflow重新生成部署文件：

git push origin --delete gh-pages

5. 检查Workflow权限设置 #

进入仓库的「Settings」→「Actions」→「General」页面：

• 确保「Allow GitHub Actions to create and approve pull requests」等核心权限已启用
• 若Workflow使用GITHUB_TOKEN，可在配置文件中添加权限声明（缺失时补充）：

permissions:
  contents: write
  pages: write
  id-token: write

内容的提问来源于stack exchange，提问作者Z-Buffer