资源函数 on Hugo 中文文档

resources.ByType

Fri, 02 Oct 2026 00:00:00 +0800

媒体类型通常是 image、text、audio、video 或 application 之一。

{{ range resources.ByType "image" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

resources.Concat

Fri, 02 Oct 2026 00:00:00 +0800

resources.Concat 函数返回拼接后的资源切片，并以目标路径作为缓存键缓存结果。每个资源必须具有相同的媒体类型。

调用资源的 Publish、Permalink 或 RelPermalink 方法时，Hugo 会把该资源发布到目标路径。

resources.Copy

Fri, 02 Oct 2026 00:00:00 +0800

{{ with resources.Get "images/a.jpg" }}
  {{ with resources.Copy "img/new-image-name.jpg" . }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ end }}
{{ end }}

TARGETPATH 相对于站点根目录。

resources.ExecuteAsTemplate

Fri, 02 Oct 2026 00:00:00 +0800

resources.ExecuteAsTemplate 函数返回由 Go 模板创建的资源，它用给定上下文解析并执行，并以目标路径作为缓存键缓存结果。

调用资源的 Publish、Permalink 或 RelPermalink 方法时，Hugo 会把该资源发布到目标路径。

resources.Fingerprint

Fri, 02 Oct 2026 00:00:00 +0800

{{ with resources.Get "js/main.js" }}
  {{ with . | fingerprint "sha256" }}
    <script src="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous"></script>
  {{ end }}
{{ end }}

Hugo 渲染出的结果大致如下：

<script src="/js/main.62e...df1.js" integrity="sha256-Yuh...rfE=" crossorigin="anonymous"></script>

尽管 resources.Fingerprint 函数最常用于 CSS 与 JavaScript 资源，但任何类型的资源都可以使用它。

哈希算法可以是 md5、sha256（默认）、sha384 或 sha512 之一。

resources.FromString

Fri, 02 Oct 2026 00:00:00 +0800

resources.FromString 函数返回由字符串创建的资源，并以目标路径作为缓存键缓存结果。

例如，要根据站点配置创建并发布一个 security.txt 文件：

layouts/baseof.html

{{ $content := printf "Contact: mailto:%s\n" site.Params.email }}
{{ with resources.FromString ".well-known/security.txt" $content }}
  {{ .Publish }}
{{ end }}

要在管道中发布，请使用 resources.Publish 函数：

resources.Get

Fri, 02 Oct 2026 00:00:00 +0800

{{ with resources.Get "images/a.jpg" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

resources.GetMatch

Fri, 02 Oct 2026 00:00:00 +0800

{{ with resources.GetMatch "images/*.jpg" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

Hugo 用大小写不敏感的 glob 模式判断是否匹配。语法规则与示例见 glob 模式速查表。

resources.GetRemote

Fri, 02 Oct 2026 00:00:00 +0800

（0.141.0 新增）返回资源上的 Err 方法已在 v0.141.0 中移除。请改用 try 语句，如下面的错误处理示例所示。

{{ $url := "https://example.org/images/a.jpg" }}
{{ with try (resources.GetRemote $url) }}
  {{ with .Err }}
    {{ errorf "%s" . }}
  {{ else with .Value }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ else }}
    {{ errorf "Unable to get remote resource %q" $url }}
  {{ end }}
{{ end }}

如上所示，当你用 Permalink、RelPermalink 或 Publish 方法发布远程资源时，Hugo 会把生成的文件放在 publishDir 的根目录下，文件名取 URL 的基名。为保证缓存键唯一，Hugo 会在原文件名后附加一个哈希值。

resources.Match

Fri, 02 Oct 2026 00:00:00 +0800

{{ range resources.Match "images/*.jpg" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

Hugo 用大小写不敏感的 glob 模式判断是否匹配。语法规则与示例见 glob 模式速查表。

resources.Minify

Fri, 02 Oct 2026 00:00:00 +0800

{{ $css := resources.Get "css/main.css" }}
{{ $style := $css | minify }}

任何 CSS、JS、JSON、HTML、SVG 或 XML 资源都可以用 resources.Minify 压缩，它以资源对象为参数。

resources.PostProcess

Fri, 02 Oct 2026 00:00:00 +0800

（0.164.0 起弃用）

请改用 templates.Defer。

resources.Publish

Fri, 02 Oct 2026 00:00:00 +0800

（0.166.0 新增）

resources.Publish 函数把给定资源写入 publishDir 并返回该资源，因此很适合用在模板管道中。

{{ resources.Get "main.js" | js.Build | resources.Publish }}

这等价于：

{{ (resources.Get "main.js" | js.Build).Publish }}

非管道形式的写法参见 Publish 方法。