resources

resources.Match

返回路径匹配给定 glob 模式的全局资源集合;一个都没有时返回 nil。

签名
resources.Match PATTERN
返回类型
resource.Resources

这一页解决什么问题

你要的是一批资源:把 assets/ 下所有图片列成图片墙、给每个数据文件生成一份表格、把某个目录下的资源全部纳入处理管道。resources.Match 用 glob 模式一次取回全部匹配项,返回的是一个可以 range、len、where、sort 的集合。

它与 resources.GetMatch 的唯一区别就是「取全部」还是「取第一个」。

什么时候用,什么时候别用

该用:

  • 处理整个目录的资源(图片墙、资源清单、批量加指纹);
  • 需要先统计数量(len)或过滤(where)再处理;
  • 想遍历子目录(用 **)。

别用:

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

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

完整示例:统计并遍历匹配结果

layouts/_partials/asset-gallery.htmlgo-html-template
{{ len (resources.Match "images/*") }} 个匹配
{{ range resources.Match "data/*" }}<li>{{ .Name }}</li>{{ end }}

assets/images/ 下有 10 个文件,assets/data/ 下有 1 个 a.json。Hugo 0.167.0 实测渲染为:

html
10 个匹配
<li>/data/a.json</li>

你应当看到什么:len 与 range 都能直接用;.Name 对全局资源是带前导斜杠的路径(实测 /data/a.json)。模式匹配不到任何文件时,返回空集合:len 为 0,在 if 里判为假,range 一次都不执行——不会报错。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,单语言站点,Windows;assets/ 下 10 个图片、1 个 JSON、5 个文本资源。

模式 结果 是否报错
"images/*" 10 个资源 否
"images/*.jpg" 1 个资源(a.jpg,f.jpg 在页面包里不属于全局资源) 否
"images/**" 10 个资源(** 覆盖该层全部) 否
"images/*.JPG" 与 "images/*.jpg" 相同——大小写不敏感 否
"images/*.xyz"(无匹配) 空集合:len 为 0,if 判假 否
返回类型 resource.Resources 否

常见坑

类别 症状 真因 怎么修
没报错但结果不对 图片墙顺序每次都不同 集合顺序不是文件名序(上游未说明规则) 用 sort 显式排序,例如 sort (resources.Match "images/*") "Name"
没报错但结果不对 少了页面包里的图 resources.Match 只看全局资源 再合并一次 .Resources.Match 的结果
报错看不懂 does not support this method: use reflect.IsImageResource… 匹配结果里混有非图片(如 .svg),却取了 .Width 用 where 按 .MediaType.Type 过滤,或加 reflect.IsImageResource 守卫
没报错但结果不对 "images/**/*.jpg" 一个都没匹配到 ** 在该模式下没有覆盖「本层文件」(实测返回空) 用 "images/*.jpg",或先 "images/**" 再用 where 过滤扩展名

更多排查入口见故障排查。