Buffalo 模板中应直接内联 SVG 代码而非使用 symbol 或外部引用，因其服务端渲染不支持浏览器端的 <use> 解析；推荐通过 Plush 辅助函数封装图标以提升可维护性，并确保返回 template.HTML 类型避免转义。
Buffalo 模板里直接写 <svg> 标签就行，别走 symbol 或外部引用那套
Buffalo 的模板引擎（Plush）本质是服务端渲染，不支持浏览器端的 <use xlink:href> 动态解析，所以别把 iconfont 的 symbol 脚本塞进 Buffalo 模板里——它不会执行，<use> 会直接被当成普通标签原样输出，图标不显示。
正确做法是把 SVG 内容直接贴进模板，用 Plush 变量控制属性。比如：
<svg width="<%= size %>" height="<%= size %>" viewBox="0 0 24 24" fill="none"> <path d="M12 2L2 7l10 5 10-5-10-5z" stroke="currentColor" stroke-width="2" fill="none"/> <path d="M2 17l10 5 10-5M2 12l10 5 10-5" stroke="currentColor" stroke-width="2" fill="none"/> </svg>
这样既能用 size 这类变量动态控制尺寸，又能让 fill、stroke 响应 CSS 的 color 继承，保持样式统一。
用 render 辅助函数封装 SVG，避免重复粘贴
如果项目里 SVG 图标超过 3 个，硬编码在每个模板里就难维护。推荐写一个 Plush 辅助函数，比如 icon：
在 app.go 的 app.ServeFiles() 之前加：
app.Helper("icon", func(name string, opts buffalo.Options) template.HTML {
icons := map[string]string{
"search": `<svg viewBox="0 0 24 24"><path d="M15.5 14h-.79l-.28-.27C15.41 12.59 16 11.11 16 9.5 16 5.91 13.09 3 9.5 3S3 5.91 3 9.5 5.91 16 9.5 16c1.61 0 3.09-.59 4.23-1.57l.27.28v.79l5 4.99L20.49 19l-4.99-5zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"/></svg>`,
"close": `<svg viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>`,
}
if svg, ok := icons[name]; ok {
return template.HTML(svg)
}
return template.HTML("")
})
然后在任何 .plush.html 模板里直接调用：
<%= icon("search", {"class": "w-5 h-5 text-gray-600"}) %>
注意：返回值必须是 template.HTML 类型，否则 Plush 会自动转义尖括号，变成纯文本。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
别用 app.Asset 加载本地 SVG 文件
Buffalo 的 app.Asset 是为静态资源（JS/CSS/图片）设计的，它返回的是 []byte，不是可嵌入 HTML 的字符串。如果你强行这么写：
<%= string(app.Asset("assets/images/icon.svg")) %>
会出现两个问题：
- SVG 中的双引号、
<、>全部被 HTML 转义，渲染出来是一堆乱码 - 每次请求都读一次文件系统，没缓存，性能差
真要从文件加载，得提前读取并注册为辅助函数，而不是运行时调用 app.Asset。
内联 SVG 后，CSS 控制颜色和尺寸要注意 scope
Buffalo 模板渲染后是完整 HTML 页面，所以 SVG 里的 fill="currentColor" 能正常继承父元素 color，但前提是你的 CSS 没用 scoped 或 Shadow DOM 隔离——Plush 不生成 scoped style，这点放心。
容易踩的坑：
- 如果用了 Tailwind，
text-red-500对 SVG 有效，但fill-red-500无效（除非你额外加了@layer utilities规则） - 不要在 SVG 标签里写
style="fill: red"，这会覆盖currentColor，失去主题适配能力 - 用
width/height属性控制大小比用 CSS 更稳定，尤其在老版 IE 兼容场景下
SVG 内联看似简单，真正落地时最麻烦的其实是路径维护和团队协作约定——没人想每次改一个图标，都要去翻 5 个不同模板文件里粘贴的那段代码。
