Jekyll构建GitHub Pages失败：exit code 1，文件缺失报错

常见修复步骤 #

• 统一文件大小写
  Linux环境大小写敏感，本地测试时的文件名大小写如果和GitHub仓库里的不一致（比如本地是favicon.ico，仓库里是Favicon.ico），htmlproofer会判定文件不存在。直接修改仓库里的文件名，和本地引用路径保持完全一致。

• 核对baseurl配置
  在_config.yml里，baseurl必须和你的GitHub Pages仓库名完全匹配（比如仓库名为my-blog，baseurl就要设为/my-blog）。本地预览时Jekyll可能忽略baseurl的影响，但GitHub构建会严格按该路径生成链接，路径不匹配就会导致文件找不到。

• 临时禁用htmlproofer排查
  刚搭建的博客可以先在_config.yml里添加以下配置，跳过htmlproofer检测，确认核心构建是否正常：

  htmlproofer:
    enabled: false
  

  推送后如果构建成功，再逐步开启htmlproofer，逐个检查链接路径是否正确。

• 修正资源引用路径
  确保CSS、JS、图标等资源的引用路径带上baseurl前缀，比如用{{ site.baseurl }}/assets/css/style.css替代直接写/assets/css/style.css，这样GitHub Pages构建时会自动补全路径前缀，避免找不到文件。

• 同步Jekyll版本
  本地Jekyll版本和GitHub Pages使用的版本不一致，可能导致生成的文件结构不同。执行bundle update github-pages同步本地版本，重新构建后再推送。

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