Hugo部署至GitHub Pages显示成功但无法访问的问题求助

以下是几个关键排查和解决步骤：

• 确认GitHub Pages部署源设置
  进入仓库的「Settings」→「Pages」页面，检查「Source」选项是否选择为「GitHub Actions」。如果之前设置的是特定分支（比如gh-pages），会和Actions部署冲突，导致实际无内容被部署。

• 深挖GitHub Actions构建日志
  点击Actions中显示「成功」的运行记录，查看每一步的日志细节：

  • 确认Hugo是否正常完成静态文件生成，有没有出现主题缺失、配置错误等警告或隐性错误；
  • 确认工作流是否正确将public/目录（Hugo默认生成目录）的内容上传部署到GitHub Pages。

• 检查Hugo配置与仓库结构

  • 打开项目根目录的config.toml（或对应格式的配置文件），确认baseURL是否设置为https://aslon1213.github.io/，路径错误会导致页面资源加载失败或404；
  • 确认仓库主分支推送的是完整的Hugo项目源码（包括主题、配置文件等），而非仅静态文件。

• 用浏览器开发者工具排查请求问题
  打开浏览器F12开发者工具，切换到「Network」标签后刷新页面：

  • 查看页面请求的状态码，如果是404，说明部署的内容为空或路径不匹配；
  • 如果是资源加载失败（403/404），大概率是baseURL配置错误导致资源引用路径不对。

• 处理GitHub Pages缓存
  部署成功后可能存在缓存延迟，尝试按Ctrl+F5强制刷新页面，或等待5-10分钟后再访问。

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