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

GitHub Pages部署Build阶段报错,求助Jekyll Scss转换问题排查建议

GitHub Pages部署Scss转换错误排查建议

你遇到的错误是Jekyll处理Scss文件时找不到/github/workspace/docs目录,以下是具体排查步骤:

  • 确认本地及GitHub仓库中是否存在docs目录,注意路径大小写(GitHub Pages对路径大小写敏感),如果不存在就创建对应目录。
  • 检查_config.yml配置文件,查看source或destination字段是否指定了docs路径,若有配置但目录不存在,要么创建目录,要么修改配置路径。
  • 打开assets/css/style.scss文件,检查所有@import语句,看是否有引用docs目录下的文件但路径写错的情况,比如错误的相对路径导致Jekyll去不存在的目录查找。
  • 本地执行bundle exec jekyll build命令测试,复现错误后更容易定位问题,比如本地是否缺少docs目录,或者目录权限是否正常。
  • 若使用GitHub Actions部署,检查工作流配置文件(如.github/workflows/pages.yml),确认步骤中是否有切换到docs目录的命令(如cd docs)但该目录不存在,或者部署时指定的源目录配置错误。

错误信息参考:

Jekyll::Converters::Scss encountered an error while converting 'assets/css/style.scss':
43
               No such file or directory @ dir_chdir - /github/workspace/docs

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.02 21:55:14