Gin模板中需用{{range}}遍历图片URL切片,后端须传[]string或导出字段结构体(如URL首字母大写),不可传逗号分隔字符串;空切片或nil时{{range}}自动跳过,加{{if}}或{{with}}可处理“暂无图片”提示;用户输入URL须在后端校验scheme并过滤伪协议,模板不负责安全校验。

模板里用 {{range}} 遍历图片 URL 列表
Gin 默认用 Go 的 html/template,不支持数组索引访问或内联表达式,必须靠 {{range}} 遍历切片。你传入的图片链接得是 []string 或 []struct{URL string} 这类可 range 的类型,不能是逗号分隔的单个字符串。
常见错误:后端把图片链接拼成 "a.jpg,b.jpg,c.jpg" 传过去,模板里写 {{.Images}} 只会原样输出一长串,{{range .Images}} 会报 range can't iterate over string。
- 后端要传切片:
c.HTML(200, "index.html", gin.H{"images": []string{"1.jpg", "2.jpg", "3.jpg"}}) - 模板里写:
{{range .images}}@@##@@{{end}} - 如果结构体字段名是大写(如
URL),模板中必须用.URL;小写字段(如url)在模板里不可见,会被忽略
图片带标题或额外字段时用结构体 + {{.FieldName}}
单纯展示链接够用,但加 caption、宽高、alt 文字等就得用结构体。Gin 不限制传什么类型,只要字段首字母大写且可导出,模板就能访问。
容易踩的坑:字段名拼错、忘记大写、或用 map[string]interface{} 时 key 写成小写导致模板取不到值。
- 定义结构体:
type ImageItem struct { URL, Alt, Caption string } - 传参:
c.HTML(200, "index.html", gin.H{"items": []ImageItem{{URL: "a.jpg", Alt: "猫"}, {URL: "b.jpg", Alt: "狗"}}}) - 模板:
{{range .items}}<figure>@@##@@<figcaption>{{.Caption}}</figcaption></figure>{{end}}
空列表时怎么避免渲染空白或报错
{{range}} 遇到 nil 或空切片会直接跳过,不执行内部内容,这是安全的。但如果你希望显示“暂无图片”提示,得用 {{with}} 或 {{if}} 包一层。
注意:{{if .images}} 对 nil 切片返回 false,对空切片([]string{})返回 true —— 这点常被忽略,导致空列表时仍进 if 分支却 range 不出内容。
- 稳妥写法(兼容 nil 和空切片):
{{if .images}}{{range .images}}@@##@@{{end}}{{else}}<p>暂无图片</p>{{end}} - 或者用
{{with}}(它对空切片也视为 false):{{with .images}}{{range .}}@@##@@{{end}}{{else}}<p>暂无图片</p>{{end}}
Gin 传参时别漏掉 html.EscapeString 风险
图片 URL 如果来自用户输入(比如表单上传后存的路径),直接塞进模板可能触发 XSS —— 虽然 html/template 默认会对 {{.}} 做 HTML 转义,但它**不会校验 URL 格式**。如果 URL 是 javascript:alert(1) 或 " onerror="alert(1),放进 src 仍可能执行。
所以关键不是模板怎么做,而是后端要提前过滤:
- 只允许
http://、https://、/开头的 URL,其他一律丢弃或替换为占位图 - 用
net/url.Parse检查 scheme 是否合法,避免伪协议 - 不要依赖前端或模板层做安全控制,Gin 渲染前就该把不可信数据清洗掉
模板本身没能力救这种问题,{{.URL | safeURL}} 这类自定义函数容易误用,不如在传参前就掐死非法值。











