GitHub Pages未拉取最新commit 站点持续展示旧版本代码

故障表现 #

• 仓库最新提交代码已为移动端、桌面端视图完成display: grid布局配置
• 线上站点加载旧版本代码：浏览器开发者工具检测不到任何grid布局相关属性
• 最新代码提交超过24小时，GitHub Pages 未自动拉取最新commit完成站点内容更新，故障原因暂不明确

排查解决步骤 #

• 核对部署配置
  进入仓库设置的Pages板块，确认部署源选择的分支、文件目录和实际提交代码的分支、静态文件存放路径完全匹配。常见配置错误包括代码提交到开发分支但Pages设置拉取主分支、构建产物目录配置错误。
• 检查部署工作流
  进入仓库Actions页面，查看Pages相关部署任务的状态：如果任务处于排队状态，等待队列调度即可；如果任务执行失败，点进任务详情查看报错日志定位问题，常见报错包含依赖安装失败、构建命令执行异常、文件权限不足。
• 手动触发强制重部署
  若配置核对无误、也无失败的部署记录，可手动触发重部署：在Pages设置的部署源配置项中，先临时切换到其他分支保存配置，等待10秒后切回正确的部署分支再次保存，即可强制触发全新的部署流程。
• 清理缓存验证
  等部署任务显示执行成功后，使用Ctrl+Shift+R（Windows系统）/Cmd+Shift+R（Mac系统）硬刷新页面，清除本地浏览器缓存。如果仍加载旧内容，属于GitHub Pages边缘CDN缓存未同步，等待10-15分钟后再次访问即可，也可通过给静态资源添加版本查询参数的方式强制拉取最新资源。
• 核对自定义域名配置（如有使用自定义域名）
  确认自定义域名的DNS解析记录指向正确，同时检查仓库根目录下的CNAME文件内容与实际使用的自定义域名完全一致，避免解析配置异常导致加载旧站点。

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