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

如何让Jekyll在Sass文件变更时自动编译?

解决Jekyll Cayman主题Sass文件变更后不编译到style.css的问题
  • 锁定Github Pages官方依赖版本
    执行bundle install后可能更新了Jekyll或相关依赖,而Github Pages使用固定版本的Jekyll和主题,本地版本不匹配会导致编译异常。

    1. 确保项目根目录的Gemfile内容如下:
      source "https://rubygems.org"
      gem "github-pages", group: :jekyll_plugins
      
    2. 运行命令更新并对齐依赖:
      bundle update github-pages
      bundle exec jekyll serve
      
  • 检查Sass文件的前置声明
    assets/css/style.scss开头必须有正确的YAML前置声明,Jekyll才会识别并编译它,确认开头是:

    ---
    ---
    

    缺少这个或者格式错误会导致Jekyll跳过编译该文件。

  • 清理Jekyll缓存和生成文件
    旧缓存可能干扰编译,执行以下命令彻底清理后重新生成:

    bundle exec jekyll clean
    rm -rf _site
    bundle exec jekyll serve
    
  • 验证主题导入语句
    确认@import "jekyll-theme-cayman";没有拼写错误,更新后的主题包如果路径有变动可能需要调整,但Cayman主题的标准导入路径就是这个,问题大概率还是出在依赖版本上。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.14 21:31:17