You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React项目部署的GitHub Pages页面未更新,求问题排查

GitHub Pages 页面未更新的排查要点
  • 核对部署源配置
    进入仓库Settings → Pages,确认部署分支和目录完全正确。比如你是否把修改后的代码/构建产物推送到了指定的分支(比如gh-pages或main),如果是基于构建产物部署,要确保路径指向的是构建输出所在的目录(比如根目录或/dist)。
  • 检查部署日志(若用自动构建)
    打开仓库的Actions标签,找到最新的GitHub Pages部署任务,查看是否有编译错误、文件上传失败等异常。很多时候自动构建流程出问题,会导致新内容根本没部署上去。
  • 强制清除浏览器缓存
    浏览器缓存是最常见的原因之一,用Ctrl+Shift+R(Windows/Linux)或Cmd+Shift+R(Mac)强制刷新页面,或者用隐私窗口访问,验证是否是缓存导致旧内容残留。
  • 确认部署分支的文件内容
    直接在GitHub上查看你的部署分支(比如gh-pages)的文件,检查修改后的响应式相关代码(CSS、JS或HTML)是否已经同步到该分支。如果文件还是旧的,说明你的推送/复制构建文件的操作没生效。
  • 排查自定义域名缓存(若有)
    如果用了自定义域名,先确认根目录的CNAME文件是否正确,再执行本地DNS缓存刷新:Windows用ipconfig /flushdns,Mac用sudo dscacheutil -flushcache,避免域名解析缓存导致旧内容展示。
  • 确认GitHub Pages服务状态
    偶尔GitHub Pages会出现服务延迟或故障,可检查官方状态确认服务是否正常运行。

内容的提问来源于stack exchange,提问作者Emmanuel Lerma

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.14 00:40:42