Hugo Pipes 资源处理必须严格遵循 assets/ 起点→预处理（toCSS/TailwindCSS）→minify→fingerprint 链条，static/ 文件不参与管道，路径错误或顺序颠倒将导致 nil 返回、panic 或样式失效。
resources.Get 只认 assets/，static/ 下的 CSS 不进管道
直接把 main.css 放进 static/css/，再在模板里写 resources.Get "css/main.css" —— 这会静默返回空值，.Permalink 输出为空字符串或触发 panic（取决于 Hugo 版本）。Hugo Pipes 的资源系统只扫描项目根目录下的 assets/，完全忽略 static/。
必须把文件放在 assets/css/main.css，调用时路径写 "css/main.css"。主题自带的 CSS（如 themes/mytheme/assets/css/theme.css）也能被识别，但会被项目级 assets/ 覆盖。
- 路径错、目录错 →
resources.Get返回 nil，后续链式调用（如| minify）直接报错或静默失效 - 用了 Hugo Modules？挂载点路径（如
github.com/example/theme）必须和resources.Get中写的路径完全一致 -
static/里的文件只做“原样复制”，不参与任何 Pipes 处理，也不生成哈希或压缩版本
toCSS / TailwindCSS 必须在 minify 之前，顺序不能颠倒
预处理器（Sass、SCSS、Tailwind）输出的是中间 CSS 内容，不是最终可部署的样式文件。Hugo 要求所有转换必须在 minify 前完成，否则会报错或产出无效 CSS。
例如处理 Tailwind：{{ $css := resources.Get "css/main.css" | css.TailwindCSS (dict "inlineImports" true) | minify | fingerprint }}。如果把 minify 放前面，css.TailwindCSS 就收不到原始内容，构建失败。
-
toCSS默认用 libsass，不支持@use或 Dart Sass 新语法；要支持，得配外部二进制并启用--enableGitInfo -
css.TailwindCSS不自动解析@import的局部文件（如_variables.scss），所有依赖必须显式写在入口文件里 - Sass 源文件已是
.min.css？minify仍会执行，结果不一定更小，但能确保输出格式统一
fingerprint 是缓存失效的关键，不用它就等于没更新
fingerprint 不只是加个哈希后缀——它默认用 sha256 生成哈希，重命名文件（如 main.a1b2c3d4.css），同时提供 .Data.Integrity 字段供 SRI 校验。没它，浏览器可能长期缓存旧 CSS，改了样式也看不到。
必须用 $css.Permalink，.RelPermalink 对资源对象无效，会输出空字符串。常见错误是误写成 {{ .Site.Params.css | relURL }} 或拼接字符串路径。
- 多个 CSS 合并要用
resources.Concat，不能靠slice | resources.Get拼接——后者不会真正合并内容，只是生成一组独立 resource 对象 -
minify不只是删空格：它会重写选择器、合并重复声明、移除无效规则，实际体积缩减比想象中更显著 - 想内联 CSS？用
{{ $css.Content | safeCSS }}，不是.Permalink；漏掉safeCSS会导致标签被转义失效
HTML 文件压根不能走 Pipes，别试了
resources.Get "index.html" 总是返回 nil，因为 Hugo 不把 HTML 当作可管道资源。页面模板（layouts/）、内容文件（content/）、静态 HTML（static/）都不归 Pipes 管理。
想给 HTML 加哈希或压缩？绕开 Pipes：用 markup.goldmark.renderer 配置控制输出空白，或写 render-hook；想注入样式内容，用 resources.FromString + .Content 构建临时资源再 ExecuteAsTemplate，但注意传入上下文，否则 {{ .Title }} 类语法会报 nil pointer 错误。
- 把
index.html放进assets/→resources.Get能拿到，但.Minify和.Fingerprint会失败（HTML 类型不支持） - 试图用
ExecuteAsTemplate渲染纯 HTML 文件？可以，但文件里不能含 Hugo 模板语法，否则必须确保上下文完整 - 内联 ≠ 临界 CSS：Pipes 生成的是全量 CSS，首屏渲染仍可能 FOUC；真要临界 CSS，得额外提取并手动注入
路径和顺序是唯一入口和不可妥协的链条：assets/ 是起点，toCSS 或 TailwindCSS 是必经转换，minify 是压缩关卡，fingerprint 是交付终点。错一步，要么构建中断，要么样式不生效，还查不出原因。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
