GitHub Actions部署阶段失败，提示Error: Process completed with exit code 1求助

• 检查Jekyll构建依赖版本

  • 确认仓库内Gemfile和Gemfile.lock与主题官方版本一致，重点核对Jekyll、bundler的版本。先在本地执行bundle install和bundle exec jekyll build，若本地构建失败，先解决本地问题再推送代码。
  • 若本地构建正常，查看.github/workflows/pages-deploy.yml中的Ruby版本是否与本地环境匹配，版本不兼容易引发依赖问题。

• 排查配置与内容格式错误

  • 检查_config.yml内的核心配置，比如url、baseurl是否设置正确，自定义域名场景下不要留空或填写错误地址。
  • 核对最近新增的文章、页面的Front Matter（如title、date、categories），确认格式合规，比如日期格式是否正确、冒号后是否有空格，这类语法错误会直接导致构建终止。

• 清理缓存并开启调试日志

  • 重新运行GitHub Actions工作流时，勾选「Enable debug logging」，通过详细日志定位具体报错点（exit code 1为通用错误，调试日志会显示具体文件或代码的问题）。
  • 本地执行bundle exec jekyll clean清理缓存后重新构建，排除缓存引发的异常。

• 适配主题专属部署要求

  • 确认仓库Pages设置中，构建来源选择「GitHub Actions」而非「Deploy from a branch」，这是该主题部署的必要配置。
  • 检查.github/workflows/pages-deploy.yml是否为主题官方提供的最新版本，主题更新后需同步工作流配置，避免旧配置与新主题代码冲突。

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