一句话结论
Hugo 0.158 起移除内置 libsass,带 SCSS 的主题会直接构建失败;装 dart-sass 二进制并软链到 PATH 即可恢复。
为什么(原理)
旧版 extended 把 libsass 编进二进制,resources.ToCSS 开箱可用。新版改为调用外部 Dart Sass 进程,Hugo 只负责启动,所以机器上必须存在 sass 可执行文件。
怎么做(命令与配置)
| |
验证方式与预期输出
sass --version 打印出 1.77.8 之类的版本号,之后 hugo --minify 不再报 SCSS 相关错误。
踩坑
- 只装
hugo_extended不够,报错指向 SCSS,容易误判成主题问题。 apt install sass常装到旧版 Ruby sass,语法兼容差,优先官方 dart-sass 二进制。