Hugo 0.158 之后构建 SCSS 报错:内置 libsass 已移除

常青 已验证 最后核对 2026-11-21

一句话结论

Hugo 0.158 起移除内置 libsass,带 SCSS 的主题会直接构建失败;装 dart-sass 二进制并软链到 PATH 即可恢复。

为什么(原理)

旧版 extended 把 libsass 编进二进制,resources.ToCSS 开箱可用。新版改为调用外部 Dart Sass 进程,Hugo 只负责启动,所以机器上必须存在 sass 可执行文件。

怎么做(命令与配置)

1
2
3
4
5
6
V=1.77.8
curl -sL -o /tmp/dart-sass.tar.gz https://github.com/sass/dart-sass/releases/download/${V}/dart-sass-${V}-linux-x64.tar.gz
mkdir -p /opt/dart-sass
tar -xzf /tmp/dart-sass.tar.gz -C /opt/dart-sass --strip-components=1
ln -sf /opt/dart-sass/sass /usr/local/bin/sass
sass --version

验证方式与预期输出

sass --version 打印出 1.77.8 之类的版本号,之后 hugo --minify 不再报 SCSS 相关错误。

踩坑

  • 只装 hugo_extended 不够,报错指向 SCSS,容易误判成主题问题。
  • apt install sass 常装到旧版 Ruby sass,语法兼容差,优先官方 dart-sass 二进制。
用 Obsidian 写,用 Git 存,用 Hugo 发布。
使用 Hugo 构建