新创建的Jekyll站点部分页面返回404错误求助

• 核对页面文件与Jekyll规则
  先确认blog.html的位置：如果放在项目根目录，Jekyll默认会处理；如果放在自定义目录（比如_pages），要确保_config.yml里没限制该目录的读取。另外检查页面的YAML前端配置，要是设置了permalink: /blog/，那访问路径得是https://asafd1.github.io/blog/而非.html后缀的地址——Jekyll默认生成“干净URL”，如果要保留.html后缀，得在_config.yml里设置permalink: /:title.html，或者给单个页面显式指定带后缀的permalink。

• 检查gh-pages分支的文件完整性
  直接查看仓库的gh-pages分支，确认blog.html是否存在。如果不存在，说明Jekyll构建时没生成这个文件，得去看Actions构建日志里的Jekyll输出，有没有模板报错、变量未定义之类的问题，这些都会导致页面构建失败。

• 核对_config.yml关键配置

  • baseurl必须设为空字符串""或者"/"，因为你的站点部署在根域名（asafd1.github.io），要是填了/blog这类前缀，所有页面路径都会多一层，自然访问不到。
  • 检查include配置项，要是自定义了这个列表，得确保blog.html所在的目录被包含进去，不然Jekyll会忽略该目录下的文件。

• 确认Actions工作流的部署配置
  检查peaceiris/actions-gh-pages@v4的参数，publish_dir必须设为_site——这是Jekyll生成静态文件的默认目录，要是填错路径，会导致部分文件没被推送到gh-pages分支。另外看工作流日志，确认构建阶段是否完整执行，有没有中途中断的情况。

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