<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Hugo on Lunaire 的笔记</title><link>https://lunaire91.bbroot.com/tags/hugo/</link><description>Recent content in Hugo on Lunaire 的笔记</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><lastBuildDate>Sat, 21 Nov 2026 09:40:00 +0800</lastBuildDate><atom:link href="https://lunaire91.bbroot.com/tags/hugo/index.xml" rel="self" type="application/rss+xml"/><item><title>Hugo 0.158 之后构建 SCSS 报错：内置 libsass 已移除</title><link>https://lunaire91.bbroot.com/n/hugo-dart-sass/</link><pubDate>Sat, 21 Nov 2026 09:40:00 +0800</pubDate><guid>https://lunaire91.bbroot.com/n/hugo-dart-sass/</guid><description>&lt;h2 id="一句话结论"&gt;&lt;a href="#%e4%b8%80%e5%8f%a5%e8%af%9d%e7%bb%93%e8%ae%ba" class="header-anchor"&gt;&lt;/a&gt;一句话结论&#10;&lt;/h2&gt;&lt;p&gt;Hugo 0.158 起移除内置 libsass，带 SCSS 的主题会直接构建失败；装 dart-sass 二进制并软链到 PATH 即可恢复。&lt;/p&gt;&#10;&lt;h2 id="为什么原理"&gt;&lt;a href="#%e4%b8%ba%e4%bb%80%e4%b9%88%e5%8e%9f%e7%90%86" class="header-anchor"&gt;&lt;/a&gt;为什么（原理）&#10;&lt;/h2&gt;&lt;p&gt;旧版 extended 把 libsass 编进二进制，&lt;code&gt;resources.ToCSS&lt;/code&gt; 开箱可用。新版改为调用外部 Dart Sass 进程，Hugo 只负责启动，所以机器上必须存在 &lt;code&gt;sass&lt;/code&gt; 可执行文件。&lt;/p&gt;&#10;&lt;h2 id="怎么做命令与配置"&gt;&lt;a href="#%e6%80%8e%e4%b9%88%e5%81%9a%e5%91%bd%e4%bb%a4%e4%b8%8e%e9%85%8d%e7%bd%ae" class="header-anchor"&gt;&lt;/a&gt;怎么做（命令与配置）&#10;&lt;/h2&gt;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;span class="lnt"&gt;2&#10;&lt;/span&gt;&lt;span class="lnt"&gt;3&#10;&lt;/span&gt;&lt;span class="lnt"&gt;4&#10;&lt;/span&gt;&lt;span class="lnt"&gt;5&#10;&lt;/span&gt;&lt;span class="lnt"&gt;6&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nv"&gt;V&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;1.77.8&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -sL -o /tmp/dart-sass.tar.gz https://github.com/sass/dart-sass/releases/download/&lt;span class="si"&gt;${&lt;/span&gt;&lt;span class="nv"&gt;V&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;/dart-sass-&lt;span class="si"&gt;${&lt;/span&gt;&lt;span class="nv"&gt;V&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;-linux-x64.tar.gz&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;mkdir -p /opt/dart-sass&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;tar -xzf /tmp/dart-sass.tar.gz -C /opt/dart-sass --strip-components&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="m"&gt;1&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;ln -sf /opt/dart-sass/sass /usr/local/bin/sass&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;sass --version&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;h2 id="验证方式与预期输出"&gt;&lt;a href="#%e9%aa%8c%e8%af%81%e6%96%b9%e5%bc%8f%e4%b8%8e%e9%a2%84%e6%9c%9f%e8%be%93%e5%87%ba" class="header-anchor"&gt;&lt;/a&gt;验证方式与预期输出&#10;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;sass --version&lt;/code&gt; 打印出 &lt;code&gt;1.77.8&lt;/code&gt; 之类的版本号，之后 &lt;code&gt;hugo --minify&lt;/code&gt; 不再报 SCSS 相关错误。&lt;/p&gt;&#10;&lt;h2 id="踩坑"&gt;&lt;a href="#%e8%b8%a9%e5%9d%91" class="header-anchor"&gt;&lt;/a&gt;踩坑&#10;&lt;/h2&gt;&lt;ul&gt;&#10;&lt;li&gt;只装 &lt;code&gt;hugo_extended&lt;/code&gt; 不够，报错指向 SCSS，容易误判成主题问题。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;apt install sass&lt;/code&gt; 常装到旧版 Ruby sass，语法兼容差，优先官方 dart-sass 二进制。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;</description></item></channel></rss>