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
相关产品推荐
相关产品推荐

